Add support

to discovering instance staff
jhass · Dec 17, 2023 · ffef454 · ffef454
1 parent 87f6d8d
commit ffef454
Show file tree

Hide file tree

Showing 2 changed files with 55 additions and 0 deletions.
diff --git a/schemas/2.2/example.json b/schemas/2.2/example.json
@@ -3,6 +3,20 @@
   "instance": {
     "name": "New FI𝑓F"
   },
+  "support": {
+    "contacts": [
+      {
+          "account": "ordnung",
+          "email": "contact@diasp.example",
+          "role": "admin"
+      },
+      {
+          "email": "security@diasp.example",
+          "role": "security"
+      }
+    ],
+    "support_page": "https://diasp.example/support.html"
+  },
   "software": {
     "name": "diaspora",
     "version": "0.5.0",

diff --git a/schemas/2.2/schema.json b/schemas/2.2/schema.json
@@ -8,6 +8,7 @@
   "required": [
     "version",
     "instance",
+    "support",
     "software",
     "protocols",
     "services",
@@ -34,6 +35,46 @@
         }
       }
     },
+    "support": {
+      "description": "Support information of an instance.",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "contacts": {
+          "description": "Support contacts of an instance.",
+          "type":"array",
+          "items": {
+            "description": "Support contact",
+            "type": "object",
+            "minProperties": 2,
+            "additionalProperties": false,
+            "properties": {
+              "account": {
+                "description": "The account identifier in this instance belonging to the contact.",
+                "type": "string",
+                "pattern": "^.{0,500}$"
+              },
+              "email": {
+                "description": "Email belonging to the contact.",
+                "type": "string",
+                "pattern": "^.{0,500}$"
+              },
+              "role": {
+                "description": "Informal description of what the contact is used for. Common roles are 'admin', 'moderator', 'security'.",
+                "type": "string",
+                "pattern": "^.{0,500}$"
+              }
+            }
+          }
+        },
+        "support_page": {
+          "description": "Specify a affiliated page of the instance to give users help.",
+          "type": "string",
+          "format": "uri",
+          "pattern": "^https?://"
+        }
+      }
+    },
     "software": {
       "description": "Metadata about server software in use.",
       "type": "object",