Add what is JSON Hyper Schema to the Glossary

[benjagm]

It would be great to add a definition of what is JSON Hyper Schema to the Glossary.

Related: json-schema-org/understanding-json-schema#28

[sudo-jarvis]

Hi @benjagm, I would like to work on this issue. Please assign it to me

[Akshaybagai52]

Hi @benjagm
can you assign this issue to me
Thanks

[benjagm]

Thanks everyone for your interest. Next time, let make sure everyone waits to receive assignation before you start working on the PR.

[Sanket-0510]

@benjagm can you please assign this to me, I have worked on this before, I would like to continue and apologies for not getting it assigned before.

[benjagm]

@Sanket-0510 let's give @Akshaybagai52 the chance to contribute on this one.

[benjagm]

Hi @benjagm
can you assign this issue to me
Thanks

All yours @Akshaybagai52 . Please see #327 before you start working on this.

[Akshaybagai52]

Thanks @benjagm would love to contribute to this

[Akshaybagai52]

Hey @benjagm can you tell me what should be the length of the definition in it?

[benjagm]

what should be the length of the definition in it?

Ideally something with the same proportion than other definitions in the glossary.

[Akshaybagai52]

Refere

Okay thanks

[Akshaybagai52]

@benjagm
can you check this is this good? :-

JSON Hyper-Schema extends JSON Schema, offering a vocabulary to annotate JSON documents with hypermedia controls. This extension facilitates the description of links and actions that can be executed on JSON data, making it a potent tool for developing hypermedia-driven APIs.

Built upon the foundation of JSON Schema, JSON Hyper-Schema introduces additional keywords to specify hyperlinks and instructions for handling remote JSON resources in hypermedia environments like HTTP. The Link Description Object (LDO) is a core concept, encapsulating information about available actions. LDO properties include "rel" (relation type), "href" (URI template), and "templateRequired" (required template variables).

The "href" keyword in JSON Hyper-Schema is crucial, allowing the description of URLs using flexible URI templates with variables resolved against instance data. Concepts like "base" establish the URI base for references, aiding in constructing relative URLs. The "links" property associates Link Description Objects with instances, enabling the definition of multiple links and their relations.

In conclusion, JSON Hyper-Schema enhances JSON Schema, introducing a vocabulary for hypermedia controls and enabling the creation of more interactive APIs. It provides a structured approach to articulate links and actions on JSON documents, enhancing client understanding and interaction with remote JSON resources.

[jdesrosiers]

@Akshaybagai52 This is a great start! Please create a PR as it will be easier to provide feedback.

[Akshaybagai52]

@Akshaybagai52 This is a great start! Please create a PR as it will be easier to provide feedback.

can you review this #367
Thanks