Make ordering of keys consistent

[retrosight]

It's the little details that matter in life -- we love consistency, so let's bring it to all of the schemas.

One example of many...

"$schema": "http://json-schema.org/draft-08/hyper-schema#",     "$id": "http://json-schema.org/draft-08/hyper-schema-output",
"$id": "http://json-schema.org/draft-08/hyper-schema#",         "$schema": "http://json-schema.org/draft-08/schema#",
"title": "JSON Hyper-Schema",                                   [Missing]
...

[awwright]

It would seem to me that, if order matters, $schema should go first, since that's the key that gives all the others their meaning.

... with the exception of $id, so I could be persuaded otherwise.

[gregsdennis]

While I understand the motivation of this (and agree somewhat), it feels weird to me that the sequence of keys in a key-value pair collection matters. The entire purpose of having the key-value paradigm is to get around requiring order and allow easy access to the values.

Furthermore JSON declares that while arrays are to be considered "ordered" (or, more properly, "sequenced"), objects are not. This may cause confusion with authors and consumers.

---

@retrosight are you asking for this to help with schema equality comparisons, or do you have another purpose?

[gregsdennis]

See also #538 & #475

[retrosight]

Yes, I understand order does not matter to the computers. ;-) I'm looking for the consistency to aid learning while reading between different schemas. The reader doesn't have to context switch the order.

[Relequestual]

I have no issue with ordering the meta schemas we provide.
They ARE intended to be read by humans, and so we should make that as easy as possible, where possible.

PR welcome.

[handrews]

I'm fine with this- order (as it relates to our published meta-schemas and whatnot) should be:

1. $schema
2. $id
3. $vocabulary
4. $recursiveAnchor
5. base (Hyper-Schema)
6. title
7. description
8. $ref, $recursiveRef, or an allOf of those things
9. type
10. type-specific validation and applicator keywords
11. default and examples
12. links (Hyper-Schema)
13. $defs

I just updated all of the meta-schemas in a PR. I'm not 100% sure I got all of them in the same order, it's late so I'll look at it tomorrow or anyone else feel free to comment on PR #714