Skip to content

Commit 344b6f8

Browse files
committed
add section for format registry; add requirements to support those formats as well
1 parent 0843b8a commit 344b6f8

File tree

1 file changed

+11
-5
lines changed

1 file changed

+11
-5
lines changed

specs/jsonschema-validation.md

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -328,10 +328,10 @@ an annotation.
328328

329329
Implementations:
330330

331-
- SHOULD provide validation for each format attribute defined in this
332-
document;
333-
- MAY support format values not defined in this document, but such support MUST
334-
be configurable and disabled by default;
331+
- SHOULD provide validation for each format attribute defined in this document
332+
and listed in the {{format-registry}};
333+
- MAY support format values not defined in this document or listed in the
334+
registry, but such support MUST be configurable and disabled by default;
335335
- SHOULD use a common parsing library or a well-known regular expression for
336336
each format;
337337
- SHOULD clearly document how and to what degree each format attribute is
@@ -342,7 +342,13 @@ syntactic checking; implementations SHOULD NOT attempt to send an email, connect
342342
to a URL, or otherwise check the existence of an entity identified by a format
343343
instance.
344344

345-
#### Custom format values
345+
#### Format Registry {#format-registry}
346+
347+
In addition to the formats defined by this document, JSON Schema also maintains a registry of formats defined by other specifications and organizations. As of the publication of this document, the format registry can be found at https://github.com/json-schema-org/json-schema-spec/blob/main/specs/format-registry.json.
348+
349+
Implementations SHOULD support the formats listed in this registry as if they were defined by this document.
350+
351+
#### Custom `format` Values
346352

347353
Implementations MAY support custom format values. Save for agreement between
348354
parties, schema authors SHALL NOT expect a peer implementation to support such

0 commit comments

Comments
 (0)