Add examples of possible usage of the OpenAPI->Hydra parser

[Mec-iS]

No description provided.

[vaibhavchellani]

on it !

[Mec-iS]

Remember also to create a "conversion list" to document the mappings from OpenAPI syntax/semantics to Hydra semantics, i.e.:

*OpenAPI*: {"type": "array", "items": { "$ref": "#/some-reference/..."}}

*Hydra*: { "Collection1" { "hydra:member": "Type1" }}

So to have a general idea of what happens in the parser.

[Mec-iS]

@vaibhavchellani
Instead of proposing one entire example, I would write some examples demonstrating different use-case.
For example:

• how to document a collection, starting from the OpenAPI chunk and explaining the result after parsing
• same for how to document an external reference
• same for how to document a schema
• ...
  So the user can find and see easily multiple smaller examples instead of another long one (we have already that in the file about deploying hydrus)