Skip to content

Commit 30bcad4

Browse files
committed
Rework emphases throughout the page.
Emphasize the initial link to the migration notes page a bit more, but leave the section further down as people still often miss links in text. Rework the meta-schema instructions as all-bold was too heavy and obscured the important parts of the sentence. Change "Other versions" to "Older drafts" to be more clear about what the link points to. There are not other versions in the sense of other currently valid versions.
1 parent 0db9ac4 commit 30bcad4

File tree

1 file changed

+6
-4
lines changed

1 file changed

+6
-4
lines changed

documentation.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,9 @@ layout: page
33
title: Specification
44
---
55

6-
The latest Internet-Drafts at the IETF are the draft-wright-json-schema\*-01 documents, which correspond to the draft-06 meta-schemas. These were published on 2017-04-15. (Due to a change in authorship the I-D numbering was reset with the previous draft). Please see the [release notes](draft-06/README.md) for more information on this release and information on migrating from previous drafts.
6+
The latest Internet-Drafts at the IETF are the draft-wright-json-schema\*-01 documents, which correspond to the draft-06 meta-schemas. These were published on 2017-04-15. (Due to a change in authorship the I-D numbering was reset with the previous draft).
7+
8+
Please see the **[migration notes](draft-06/README.md)** for more information on this release and on migrating from draft-04.
79

810
The specification is split into three parts, Core, Validation, and Hyper-Schema:
911

@@ -24,7 +26,7 @@ The latest meta-schema is draft-06.
2426
| [Core/Validation meta-schema](http://json-schema.org/schema) | Used for schemas written for pure validation. |
2527
| [Hyper meta-schema](http://json-schema.org/hyper-schema) | Used for schemas written for validation and hyper-linking. |
2628

27-
**If you are accessing the above meta-schema links from a web browser, you will need to save the file then open it as a JSON file.**
29+
_If you are accessing the above meta-schema links **from a web browser**, you will need to **save the file** then open it as a JSON document._
2830

2931
Migrating from draft-04
3032
-------------
@@ -34,7 +36,7 @@ The release notes discuss the changes impacting users and implementors:
3436
- [JSON Schema Core and Validation](draft-06/json-schema-migration-faq.md)
3537
- [JSON Hyper-Schema](draft-06/json-hyper-schema-migration-faq.md)
3638

37-
Other versions
38-
--------------
39+
Older drafts
40+
------------
3941

4042
Please see [Specification Links](specification-links.md) for older drafts and the latest unreleased version of the specification.

0 commit comments

Comments
 (0)