[Docs] Updated 'Miscellaneous Examples' Section

[aku1310]

Keywords already in use: $id, $schema, title, properties, description, type, minimum, maximum, required, $defs, and $ref.

Keywords added: enum, pattern, dependencies, if, then, else.

I have added some examples which showcased the use of other keywords and structures, and were relatively shorter to be added in the miscellaneous section.

I feel like the other examples which use vocabulary for specific application formats, hypermedia, etc. can be made longer to properly show their usage using a specific use case as well.

Please let me know what you think about this.

[gregsdennis]

Thanks for submitting! Some things to take care of.

[aku1310]

Thanks for submitting! Some things to take care of.

Thank you for the feedback!
I'll make the suggested changes and update the PR soon.

[benjagm]

I love what you have done to provide a better introduction to each example. That was exactly what I was referring to when I asked to provide a more consistent format for examples.

Regarding the code and keywords thanks a lot @gregsdennis for the comments here. Those are the changes we should include. If you need additional inputs feel free to reach out to @gregsdennis or me and we'll help you.

Nice job overall! You are taking our docs to the next level!

[aku1310]

Hi @gregsdennis @benjagm,

I have updated the PR with the suggested changes. Please let me know what you think about this. 😊

Thank you!

[gregsdennis]

Very good edits. I've left a few comments.

[aku1310]

Very good edits. I've left a few comments.

Thank you!! I'll make the changes and update the PR soon.

[gregsdennis]

I'm happy with this. I'd like to get a second opinion on one thing.

[benjagm]

Everything looks great. The only thing I noticed is this page will benefit from providing an index at the beginning to better help users to understand what to expect. Something like start the page this way instead of providing the first example:

In this page you will find examples illustrating different uses cases to help you get the most out of your JSON Schemas, including:

• A typical minimum schema
• Describing geographical coordinates
• Arrays of things
• Enumerated values
• Regular expression pattern
• Complex object with nested properties
• Conditional validation with dependentRequired
• Conditional validation with dependentSchemas
• Conditional validation with if-else

[aku1310]

Everything looks great. The only thing I noticed is this page will benefit from providing an index at the beginning to better help users to understand what to expect. Something like start the page this way instead of providing the first example:

In this page you will find examples illustrating different uses cases to help you get the most out of your JSON Schemas, including:

• A typical minimum schema
• Describing geographical coordinates
• Arrays of things
• Enumerated values
• Regular expression pattern
• Complex object with nested properties
• Conditional validation with dependentRequired
• Conditional validation with dependentSchemas
• Conditional validation with if-else

Thank you! Just updated this. Please let me know if this works 😊

[benjagm]

Approved! Did a small change to fix relative urls in the index links.

Great work again @aku1310!
Thanks @gregsdennis and @jdesrosiers for the great feedback.