annotate mod_service_outage_status/README.markdown @ 5766:b8a2b3ebe792

mod_http_oauth2: Return validation output added in trunk rev 72d7830505f0 It's not fun at all to try to register a client and only get back "failed schema validation", this should help with that.
author Kim Alvefur <zash@zash.se>
date Sun, 03 Dec 2023 23:44:18 +0100
parents 03044a6f5f4c
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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.