json-schema-spec
json-schema-spec copied to clipboard
Add some paragraphs to Overview to put some context to "vocabulary"
The Overview is the first section of the document that describes how JSON Schema accomplishes the goals laid out in the abstract and the introduction.
Currently, it jumps to talking about vocabularies and keywords before the definition can be meaningful to readers. This PR adds some context to that, and provides a good primer for the essential mechanics of how schemas are read, at a more "architectural" level.
Note: before we merge anything to draft-next we need to sync it up with the latest changes to main/master.
The draft-next
branch has been merged and is now closed. The merge target for this PR has been changed to main
. Here are the recommended steps to get your branch reabsed properly.
- Make sure your remote for the
json-schema-org/json-schema-spec
repo is up-to-date. (Example:git fetch upstream
). - Rebase your commits onto
main
. (Example:git rebase --onto upstream/main abcd123~1
(replaceabcd123
with the commit hash of the first commit in your PR)). - Force push the rebased branch to your fork. (Example:
git push --force origin my-branch
).
That's exactly what I'm looking for. In most cases I'm not sure what language would improve on the issues you identified, maybe you can suggest something?
That's exactly what I'm looking for. In most cases I'm not sure what language would improve on the issues you identified, maybe you can suggest something?
Sorry, just saw this one too, and I assume it's in response to one of my comments above, will try to suggest something!
I trimmed this down a bit. This meshes nicely with #1365 and should go in first, and it sets up for some changes that will likely be made in that issue.