Skip to content

Commit 8bd7f2c

Browse files
committed
Explain why plain name fragments are as they are
Because XML is/was the most likely need for cross-media-type fragment identifiers.
1 parent d59bda8 commit 8bd7f2c

File tree

1 file changed

+5
-2
lines changed

1 file changed

+5
-2
lines changed

jsonschema-core.xml

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1458,8 +1458,11 @@
14581458
If present, the value of this keyword MUST be a string and MUST start with
14591459
a letter ([A-Za-z]) or underscore ("_"), followed by any number of letters,
14601460
digits ([0-9]), hyphens ("-"), underscores ("_"), and periods (".").
1461-
This matches the US-ASCII part of XML's
1462-
<xref target="xml-names">NCName production</xref>.
1461+
Due to the once-common practice of providing resource representations in
1462+
both JSON and XML, this matches the US-ASCII part of XML's
1463+
<xref target="xml-names">NCName production</xref>, which is noted in the
1464+
<xref target="W3C.WD-fragid-best-practices-20121025">WC3's best practices for fragment identifiers</xref>
1465+
as the typical plain name syntax for XML-based formats.
14631466
<cref>
14641467
Note that the anchor string does not include the "#" character,
14651468
as it is not a IRI-reference. An "$anchor": "foo" becomes the

0 commit comments

Comments
 (0)