| Set a non-empty description at the top level of the schema to explain what the definition is about in detail | |
| Set a non-empty examples array at the top level of the schema to illustrate the expected data | |
| Wrapping `$ref` in `allOf` was only necessary in JSON Schema Draft 7 and older | /allOf/0/$ref |
| Keywords inside `allOf` that do not conflict with the parent schema can be elevated | /allOf/1/type – /allOf/1/properties |
| Set `properties` to identifier names that can be easily mapped to programming languages (matching [A-Za-z_][A-Za-z0-9_]*) | /allOf/1/properties/invalid-params |
| Descriptions should not end with a period to give user interfaces flexibility in presenting the text | /allOf/1/properties/invalid-params/description |