Skip to content

Commit 2c9cae4

Browse files
committed
removed permissive language from format requirements
1 parent 3faa6ac commit 2c9cae4

File tree

1 file changed

+6
-16
lines changed

1 file changed

+6
-16
lines changed

Diff for: jsonschema-validation.md

+6-16
Original file line numberDiff line numberDiff line change
@@ -326,29 +326,19 @@ an annotation.
326326

327327
Implementations:
328328

329-
- SHOULD provide an implementation-specific best effort validation for each
330-
format attribute defined in this document;[^3]
329+
- SHOULD provide validation for each format attribute defined in this
330+
document;
331331
- MAY support format values not defined in this document, but such support MUST
332332
be configurable and disabled by default;
333333
- SHOULD use a common parsing library or a well-known regular expression for
334334
each format;
335335
- SHOULD clearly document how and to what degree each format attribute is
336336
validated.
337337

338-
[^3]: The expectation is that for simple formats such as date-time, syntactic
339-
validation will be thorough. For a complex format such as email addresses, which
340-
are the amalgamation of various standards and numerous adjustments over time,
341-
with obscure and/or obsolete rules that may or may not be restricted by other
342-
applications making use of the value, a minimal validation is sufficient. For
343-
example, an instance string that does not contain an "@" is clearly not a valid
344-
email address, and an "email" or "hostname" containing characters outside of
345-
7-bit ASCII is likewise clearly invalid.
346-
347-
The requirement for minimal validation of format values in general is
348-
intentionally vague and permissive, due to the complexity involved in many of
349-
the attributes. Note in particular that the requirement is limited to syntactic
350-
checking; implementations SHOULD NOT attempt to send an email, connect to a URL,
351-
or otherwise check the existence of an entity identified by a format instance.
338+
The requirement for validation of format values in general is limited to
339+
syntactic checking; implementations SHOULD NOT attempt to send an email, connect
340+
to a URL, or otherwise check the existence of an entity identified by a format
341+
instance.
352342

353343
#### Custom format attributes
354344

0 commit comments

Comments
 (0)