Skip to content

Commit b517832

Browse files
committed
Settle on "2019-09" rather than "draft/2019-09"
1 parent 36e922a commit b517832

File tree

4 files changed

+13
-9
lines changed

4 files changed

+13
-9
lines changed

draft/2019-09/release-notes.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,7 @@ yes | off | not validated
104104

105105
Obviously, each implementation will behave consistently from schema to schema, although some formats may be supported more thoroughly than others despite the wording in the specification. However, complex formats are, in practice, supported to different degrees in each implementation. If they are supported at all.
106106

107-
**Summary of draft/2019-09 behavior**
107+
**Summary of 2019-09 behavior**
108108

109109
The goal with this draft is to make the default behavior predictable, with the inconsistent behavior as an opt-in feature. This is not entirely satisfactory, but we feel that it is a good first step to reduce the number of complaints seen around surprising results. This way, there should at least be fewer surprises.
110110

index.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ permalink: /
77
**NEW DRAFT PUBLISHED!**
88
{: style="color:red; font-size: 200%; text-align: center;"}
99

10-
The current version is [draft/2019-09](specification.html)!
10+
The current version is [2019-09](specification.html)!
1111
{: style="color:gray; font-size: 150%; text-align: center;"}
1212

1313
**JSON Schema** is a vocabulary that allows you to **annotate** and **validate** JSON documents.
@@ -42,7 +42,11 @@ The current version is [draft/2019-09](specification.html)!
4242

4343
16 September 2019: Draft 2019-09 (formerly known as draft-08) has been published!
4444

45-
See the [Specification page](specification.html) for details.
45+
The IETF document IDs are of the form `draft-handrews-*-02`. We are now using dates
46+
for meta-schemas, which are what implementations should use to determine behavior,
47+
so we will usually refer to `2019-09` (without the word "draft") on this web site.
48+
49+
See the [Specification page](specification.html) for details about naming and numbering.
4650

4751
### The Path to Standardization
4852

specification-links.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -208,7 +208,7 @@ For links to the somewhat more readably formatted versions on this web site, and
208208
</a></small></tt><br>
209209
</td>
210210
<td>
211-
<tt><small>draft/2019&#8209;09</small></tt>
211+
<tt><small>2019&#8209;09</small></tt>
212212
</td>
213213
<td>
214214
Draft 8

specification.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,9 @@ title: Specification
1111
Draft numbering
1212
---------------
1313

14-
The latest Internet-Drafts at the IETF are the **draft-handrews-json-schema\*-02** documents, which correspond to the **draft/2019-09** meta-schemas. These were published on **2019-09-16**.
14+
The latest Internet-Drafts at the IETF are the **draft-handrews-json-schema\*-02** documents, which correspond to the **2019-09** meta-schemas. These were published on **2019-09-16**.
1515

16-
For a full explanation of both the IETF and meta-schema numbering schemes, how they correspond, and why we are now using the date-based `draft/2019-09` rather than `draft-08`, see the [Specification Links](specification-links.html) page.
16+
For a full explanation of both the IETF and meta-schema numbering schemes, how they correspond, and why we are now using the date-based `2019-09` rather than `draft-08`, see the [Specification Links](specification-links.html) page.
1717

1818
Specification documents
1919
-----------------------
@@ -41,7 +41,7 @@ Meta-schemas
4141

4242
The meta-schemas are schemas against which other schemas can be validated. They are self-descriptive: the JSON Schema meta-schema validates itself, while the JSON Hyper-Schema meta-schema both validates itself and defines its own "self" link.
4343

44-
The latest meta-schema is **draft/2019**. For an explanation of the change to date-based identifiers, see the [Specification Links](specification-links.html) page.
44+
The latest meta-schema is **2019-09**. For an explanation of the change to date-based identifiers, see the [Specification Links](specification-links.html) page.
4545

4646
_If you are accessing these JSON document links **from a web browser**, you will need to **save the file** then open it as a JSON document. This is due to limitations with GitHub Pages._
4747

@@ -76,11 +76,11 @@ Migrating from older drafts
7676
The release notes discuss the changes impacting users and implementers:
7777

7878
- JSON Schema Core and Validation
79-
- [Draft-07 to Draft 2019-09](draft/2019-09/release-notes.html)
79+
- [Draft-07 to 2019-09](draft/2019-09/release-notes.html)
8080
- [Draft-06 to Draft-07](draft-07/json-schema-release-notes.html)
8181
- [Draft-04 to Draft-06](draft-06/json-schema-release-notes.html)
8282
- JSON Hyper-Schema
83-
- [Draft-07 to Draft 2019-09](draft/2019-09/release-notes.html#hyper-schema-vocabulary)
83+
- [Draft-07 to 2019-09](draft/2019-09/release-notes.html#hyper-schema-vocabulary)
8484
- [Draft-04 to Draft-07](draft-07/json-hyper-schema-release-notes.html)
8585
- [Draft-04 to Draft-06](draft-06/json-hyper-schema-release-notes.html)
8686

0 commit comments

Comments
 (0)