Mercurial > prosody-modules
annotate mod_service_outage_status/README.markdown @ 5366:db4c66a1d24b
mod_http_oauth2: Fill in some client metadata defaults
Explicit > Implicit
Maybe we should actually use these for something as well? :)
It's is somewhat an open question of how strictly we should enforce
things in the client metadata given that it is somewhat extensible.
Especially some of these enum fields which have corresponding IANA
registries.
author | Kim Alvefur <zash@zash.se> |
---|---|
date | Tue, 25 Apr 2023 18:09:08 +0200 |
parents | 03044a6f5f4c |
children |
rev | line source |
---|---|
5338
03044a6f5f4c
mod_service_outage_status: XEP-0455: Service Outage Status
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
1 This module allows advertising a machine-readable document were outages, |
03044a6f5f4c
mod_service_outage_status: XEP-0455: Service Outage Status
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
2 planned or otherwise, may be reported. |
03044a6f5f4c
mod_service_outage_status: XEP-0455: Service Outage Status
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
3 |
03044a6f5f4c
mod_service_outage_status: XEP-0455: Service Outage Status
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
4 See [XEP-0455: Service Outage Status] for further details, including |
03044a6f5f4c
mod_service_outage_status: XEP-0455: Service Outage Status
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
5 the format of the outage status document. |
03044a6f5f4c
mod_service_outage_status: XEP-0455: Service Outage Status
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
6 |
03044a6f5f4c
mod_service_outage_status: XEP-0455: Service Outage Status
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
7 ```lua |
03044a6f5f4c
mod_service_outage_status: XEP-0455: Service Outage Status
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
8 modules_enabled = { |
03044a6f5f4c
mod_service_outage_status: XEP-0455: Service Outage Status
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
9 -- other modules |
03044a6f5f4c
mod_service_outage_status: XEP-0455: Service Outage Status
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
10 "service_outage_status", |
03044a6f5f4c
mod_service_outage_status: XEP-0455: Service Outage Status
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
11 } |
03044a6f5f4c
mod_service_outage_status: XEP-0455: Service Outage Status
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
12 |
03044a6f5f4c
mod_service_outage_status: XEP-0455: Service Outage Status
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
13 outage_status_urls = { |
03044a6f5f4c
mod_service_outage_status: XEP-0455: Service Outage Status
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
14 "https://uptime.example.net/status.json", |
03044a6f5f4c
mod_service_outage_status: XEP-0455: Service Outage Status
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
15 } |
03044a6f5f4c
mod_service_outage_status: XEP-0455: Service Outage Status
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
16 ``` |
03044a6f5f4c
mod_service_outage_status: XEP-0455: Service Outage Status
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
17 |
03044a6f5f4c
mod_service_outage_status: XEP-0455: Service Outage Status
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
18 The outage status document should be hosted on a separate server to |
03044a6f5f4c
mod_service_outage_status: XEP-0455: Service Outage Status
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
19 ensure availability even if the XMPP server is unreachable. |