Add a new x-links property for linking to standards

Signed-off-by: Juan Cruz Viotti <[email protected]>

Author: jviotti

meta/schemas.json

@@ -26,7 +26,7 @@
     "title",
     "description",
     "examples",
-    "$comment",
+    "x-links",
     "$schema"
   ],
   "properties": {
@@ -35,10 +35,20 @@
     },
     "$id": false,
     "$comment": {
-      "$ref": "../schemas/ietf/http/https-url.json"
+      "not": {
+        "$ref": "../schemas/ietf/uri/uri-reference.json"
+      }
     },
     "x-license": {
       "const": "https://github.com/sourcemeta/std/blob/main/LICENSE"
+    },
+    "x-links": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "$ref": "../schemas/ietf/http/https-url.json"
+      }
     }
   }
 }

schemas/ieee/posix/path-absolute.json

@@ -2,7 +2,6 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "IEEE Std 1003.1-2017 POSIX File Path (Absolute)",
   "description": "IEEE Std 1003.1-2017 POSIX absolute pathname",
-  "$comment": "https://pubs.opengroup.org/onlinepubs/9699919799/",
   "examples": [
     "/",
     "/home/user/document.txt",
@@ -11,6 +10,7 @@
     "/tmp/temp_file-123.tmp"
   ],
   "x-license": "https://github.com/sourcemeta/std/blob/main/LICENSE",
+  "x-links": [ "https://pubs.opengroup.org/onlinepubs/9699919799/" ],
   "type": "string",
   "not": {
     "$comment": "Cannot contain null bytes",

schemas/ieee/posix/path-relative.json

@@ -2,7 +2,6 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "IEEE Std 1003.1-2017 POSIX File Path (Relative)",
   "description": "IEEE Std 1003.1-2017 POSIX relative pathname",
-  "$comment": "https://pubs.opengroup.org/onlinepubs/9699919799/",
   "examples": [
     "",
     "file.txt",
@@ -11,6 +10,7 @@
     ".ssh/id_rsa"
   ],
   "x-license": "https://github.com/sourcemeta/std/blob/main/LICENSE",
+  "x-links": [ "https://pubs.opengroup.org/onlinepubs/9699919799/" ],
   "type": "string",
   "not": {
     "anyOf": [

schemas/ieee/posix/path.json

@@ -2,7 +2,6 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "IEEE Std 1003.1-2017 POSIX File Path)",
   "description": "IEEE Std 1003.1-2017 POSIX pathname",
-  "$comment": "https://pubs.opengroup.org/onlinepubs/9699919799/",
   "examples": [
     "/",
     "/home/user/document.txt",
@@ -12,6 +11,7 @@
     "../config/settings.conf"
   ],
   "x-license": "https://github.com/sourcemeta/std/blob/main/LICENSE",
+  "x-links": [ "https://pubs.opengroup.org/onlinepubs/9699919799/" ],
   "anyOf": [
     {
       "$ref": "./path-absolute.json"

schemas/ietf/email/address.json

@@ -2,7 +2,6 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "RFC 5322 Email Address (Addr-Spec)",
   "description": "A specific Internet identifier that represents an e-mail box to which messages are delivered",
-  "$comment": "https://www.rfc-editor.org/rfc/rfc5322#section-3.4.1",
   "examples": [
     "[email protected]",
     "\"[email protected]\"@example.com",
@@ -12,6 +11,7 @@
     "user@[abc.def]"
   ],
   "x-license": "https://github.com/sourcemeta/std/blob/main/LICENSE",
+  "x-links": [ "https://www.rfc-editor.org/rfc/rfc5322#section-3.4.1" ],
   "type": "string",
   "anyOf": [
     {

schemas/ietf/http/etag-strong.json

@@ -2,9 +2,9 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "RFC 9110 HTTP Strong ETag",
   "description": "A strong HTTP entity tag used for cache validation",
-  "$comment": "https://www.rfc-editor.org/rfc/rfc9110#section-8.8.3",
   "examples": [ "\"abc123\"", "\"686897696a7c876b7e\"", "\"\"" ],
   "x-license": "https://github.com/sourcemeta/std/blob/main/LICENSE",
+  "x-links": [ "https://www.rfc-editor.org/rfc/rfc9110#section-8.8.3" ],
   "type": "string",
   "pattern": "^\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"$"
 }

schemas/ietf/http/etag-weak.json

@@ -2,9 +2,9 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "RFC 9110 HTTP Weak ETag",
   "description": "A weak HTTP entity tag used for cache validation with relaxed comparison semantics",
-  "$comment": "https://www.rfc-editor.org/rfc/rfc9110#section-8.8.3",
   "examples": [ "W/\"abc123\"", "W/\"686897696a7c876b7e\"", "W/\"\"" ],
   "x-license": "https://github.com/sourcemeta/std/blob/main/LICENSE",
+  "x-links": [ "https://www.rfc-editor.org/rfc/rfc9110#section-8.8.3" ],
   "type": "string",
   "pattern": "^W/\"[\\x21\\x23-\\x7E\\x80-\\xFF]*\"$"
 }

schemas/ietf/http/etag.json

@@ -2,9 +2,9 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "RFC 9110 HTTP ETag",
   "description": "An HTTP entity tag used for cache validation, either strong or weak",
-  "$comment": "https://www.rfc-editor.org/rfc/rfc9110#section-8.8.3",
   "examples": [ "\"abc123\"", "W/\"abc123\"", "\"\"" ],
   "x-license": "https://github.com/sourcemeta/std/blob/main/LICENSE",
+  "x-links": [ "https://www.rfc-editor.org/rfc/rfc9110#section-8.8.3" ],
   "anyOf": [
     {
       "$ref": "./etag-strong.json"

schemas/ietf/http/http-url.json

@@ -2,13 +2,13 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "HTTP URL",
   "description": "A Uniform Resource Locator using the HTTP scheme",
-  "$comment": "https://www.rfc-editor.org/rfc/rfc9110#section-4.2.1",
   "examples": [
     "http://example.com",
     "http://example.com/path",
     "http://user:[email protected]:8080/api"
   ],
   "x-license": "https://github.com/sourcemeta/std/blob/main/LICENSE",
+  "x-links": [ "https://www.rfc-editor.org/rfc/rfc9110#section-4.2.1" ],
   "$ref": "../uri/url.json",
   "pattern": "^[Hh][Tt][Tt][Pp]://"
 }

schemas/ietf/http/https-url.json

@@ -2,13 +2,13 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "HTTPS URL",
   "description": "A Uniform Resource Locator using the HTTPS scheme",
-  "$comment": "https://www.rfc-editor.org/rfc/rfc9110#section-4.2.2",
   "examples": [
     "https://example.com",
     "https://example.com/path",
     "https://user:[email protected]:443/api"
   ],
   "x-license": "https://github.com/sourcemeta/std/blob/main/LICENSE",
+  "x-links": [ "https://www.rfc-editor.org/rfc/rfc9110#section-4.2.2" ],
   "$ref": "../uri/url.json",
   "pattern": "^[Hh][Tt][Tt][Pp][Ss]://"
 }