Documented how OpenAPI references are used (#145)

* Documented how OpenAPI references are used

* Added the reference sources

* Added more reference examples

* Added new heading

* Many updates to the references examples

* chore: typo fix

* chore: indent fix in example

* chore: fixes docfx issues

Signed-off-by: Vincent Biret <vibiret@microsoft.com>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <vibiret@microsoft.com>

* chore: more formatting

Signed-off-by: Vincent Biret <vibiret@microsoft.com>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <vibiret@microsoft.com>

* fix: property name

Signed-off-by: Vincent Biret <vibiret@microsoft.com>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <vibiret@microsoft.com>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <vibiret@microsoft.com>

* fix: path items references

Signed-off-by: Vincent Biret <vibiret@microsoft.com>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <vibiret@microsoft.com>

---------

Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>

Author: darrelmiller