Skip to content

docs: adds conversions trade off#170

Merged
baywet merged 1 commit into
mainfrom
docs/conversions
Jul 15, 2026
Merged

docs: adds conversions trade off#170
baywet merged 1 commit into
mainfrom
docs/conversions

Conversation

@baywet

@baywet baywet commented Jul 14, 2026

Copy link
Copy Markdown
Member

Signed-off-by: Vincent Biret <vibiret@microsoft.com>
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 0984a8b:

✅ Validation status: passed

File Status Preview URL Details
OpenAPI/OpenAPI.NET/earlier-version-serialization.md ✅Succeeded
OpenAPI/OpenAPI.NET/overview.md ✅Succeeded
OpenAPI/openapi.net/toc.yml ✅Succeeded

For more details, please refer to the build report.

@github-project-automation github-project-automation Bot moved this to In Progress 🚧 in Kiota Jul 15, 2026
@baywet baywet merged commit b67e8be into main Jul 15, 2026
3 checks passed
@baywet baywet deleted the docs/conversions branch July 15, 2026 15:37
@github-project-automation github-project-automation Bot moved this from In Progress 🚧 to Done ✔️ in Kiota Jul 15, 2026
learn-build-service-prod Bot added a commit that referenced this pull request Jul 15, 2026
* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#233)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](microsoftgraph/eol-blocker@v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Resolve syncing conflicts from repo_sync_working_branch to main (#234)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

* live refresh (#232)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#169)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](microsoftgraph/eol-blocker@v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

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

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

* live refresh (#232) (#237)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* 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



* chore: formatting issues
fix: invalid examples



* chore: more formatting



* docs: adds clarifications about $id and resources behaviour



* fix: property name



* docs: adds the page to the TOC



* docs: adds dynamic reference resolution example



* fix: path items references



* docs: updates which patterns are supported or not



---------




---------







---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>
learn-build-service-prod Bot added a commit that referenced this pull request Jul 15, 2026
* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#233)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](microsoftgraph/eol-blocker@v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Resolve syncing conflicts from repo_sync_working_branch to main (#234)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

* live refresh (#232)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#169)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](microsoftgraph/eol-blocker@v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

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

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

* live refresh (#232) (#237)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* 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



* chore: formatting issues
fix: invalid examples



* chore: more formatting



* docs: adds clarifications about $id and resources behaviour



* fix: property name



* docs: adds the page to the TOC



* docs: adds dynamic reference resolution example



* fix: path items references



* docs: updates which patterns are supported or not



---------




---------







---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* Resolve syncing conflicts from repo_sync_working_branch to main (#239)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

* live refresh (#232)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#169)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](microsoftgraph/eol-blocker@v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

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

* Chore/live refresh (#238)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#233)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](microsoftgraph/eol-blocker@v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Resolve syncing conflicts from repo_sync_working_branch to main (#234)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

* live refresh (#232)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#169)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](microsoftgraph/eol-blocker@v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

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

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

* live refresh (#232) (#237)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* 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



* chore: formatting issues
fix: invalid examples



* chore: more formatting



* docs: adds clarifications about $id and resources behaviour



* fix: property name



* docs: adds the page to the TOC



* docs: adds dynamic reference resolution example



* fix: path items references



* docs: updates which patterns are supported or not



---------




---------







---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

* feat: adds support for external anchor and relative id (#167)

* feat: adds support for external anchor and relative id

* docs: adds support version for anchor

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

---------

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

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>
learn-build-service-prod Bot added a commit that referenced this pull request Jul 15, 2026
* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

* live refresh (#232)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#169)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](microsoftgraph/eol-blocker@v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

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

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>
learn-build-service-prod Bot added a commit that referenced this pull request Jul 15, 2026
* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

* live refresh (#232)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#169)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](microsoftgraph/eol-blocker@v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

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

* Chore/live refresh (#238)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#233)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](microsoftgraph/eol-blocker@v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Resolve syncing conflicts from repo_sync_working_branch to main (#234)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

* live refresh (#232)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#169)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](microsoftgraph/eol-blocker@v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

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

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

* live refresh (#232) (#237)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* 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



* chore: formatting issues
fix: invalid examples



* chore: more formatting



* docs: adds clarifications about $id and resources behaviour



* fix: property name



* docs: adds the page to the TOC



* docs: adds dynamic reference resolution example



* fix: path items references



* docs: updates which patterns are supported or not



---------




---------







---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

* feat: adds support for external anchor and relative id (#167)

* feat: adds support for external anchor and relative id

* docs: adds support version for anchor

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

---------

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

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>
jasonjoh added a commit that referenced this pull request Jul 15, 2026
* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#233)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](https://github.com/microsoftgraph/eol-blocker/compare/v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Resolve syncing conflicts from repo_sync_working_branch to main (#234)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

* live refresh (#232)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#169)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](https://github.com/microsoftgraph/eol-blocker/compare/v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

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

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

* live refresh (#232) (#237)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* 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



* chore: formatting issues
fix: invalid examples



* chore: more formatting



* docs: adds clarifications about $id and resources behaviour



* fix: property name



* docs: adds the page to the TOC



* docs: adds dynamic reference resolution example



* fix: path items references



* docs: updates which patterns are supported or not



---------




---------







---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* Resolve syncing conflicts from repo_sync_working_branch to main (#239)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

* live refresh (#232)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#169)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](https://github.com/microsoftgraph/eol-blocker/compare/v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

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

* Chore/live refresh (#238)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#233)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](https://github.com/microsoftgraph/eol-blocker/compare/v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Resolve syncing conflicts from repo_sync_working_branch to main (#234)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

* live refresh (#232)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#169)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](https://github.com/microsoftgraph/eol-blocker/compare/v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

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

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

* live refresh (#232) (#237)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* 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



* chore: formatting issues
fix: invalid examples



* chore: more formatting



* docs: adds clarifications about $id and resources behaviour



* fix: property name



* docs: adds the page to the TOC



* docs: adds dynamic reference resolution example



* fix: path items references



* docs: updates which patterns are supported or not



---------




---------







---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

* feat: adds support for external anchor and relative id (#167)

* feat: adds support for external anchor and relative id

* docs: adds support version for anchor

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

---------

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

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

* Chore/live refresh (#240)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#233)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](https://github.com/microsoftgraph/eol-blocker/compare/v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Resolve syncing conflicts from repo_sync_working_branch to main (#234)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

* live refresh (#232)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#169)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](https://github.com/microsoftgraph/eol-blocker/compare/v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

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

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

* live refresh (#232) (#237)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* 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



* chore: formatting issues
fix: invalid examples



* chore: more formatting



* docs: adds clarifications about $id and resources behaviour



* fix: property name



* docs: adds the page to the TOC



* docs: adds dynamic reference resolution example



* fix: path items references



* docs: updates which patterns are supported or not



---------




---------







---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* Resolve syncing conflicts from repo_sync_working_branch to main (#239)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

* live refresh (#232)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#169)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](https://github.com/microsoftgraph/eol-blocker/compare/v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

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

* Chore/live refresh (#238)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#233)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](https://github.com/microsoftgraph/eol-blocker/compare/v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Resolve syncing conflicts from repo_sync_working_branch to main (#234)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

* live refresh (#232)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#169)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](https://github.com/microsoftgraph/eol-blocker/compare/v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

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

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

* live refresh (#232) (#237)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* 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



* chore: formatting issues
fix: invalid examples



* chore: more formatting



* docs: adds clarifications about $id and resources behaviour



* fix: property name



* docs: adds the page to the TOC



* docs: adds dynamic reference resolution example



* fix: path items references



* docs: updates which patterns are supported or not



---------




---------







---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

* feat: adds support for external anchor and relative id (#167)

* feat: adds support for external anchor and relative id

* docs: adds support version for anchor

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

---------

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

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Servi…
learn-build-service-prod Bot added a commit that referenced this pull request Jul 15, 2026
* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

* live refresh (#232)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#169)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](https://github.com/microsoftgraph/eol-blocker/compare/v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

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

* Chore/live refresh (#238)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#233)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](https://github.com/microsoftgraph/eol-blocker/compare/v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Resolve syncing conflicts from repo_sync_working_branch to main (#234)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

* live refresh (#232)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#169)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](https://github.com/microsoftgraph/eol-blocker/compare/v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

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

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

* live refresh (#232) (#237)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* 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



* chore: formatting issues
fix: invalid examples



* chore: more formatting



* docs: adds clarifications about $id and resources behaviour



* fix: property name



* docs: adds the page to the TOC



* docs: adds dynamic reference resolution example



* fix: path items references



* docs: updates which patterns are supported or not



---------




---------







---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

* feat: adds support for external anchor and relative id (#167)

* feat: adds support for external anchor and relative id

* docs: adds support version for anchor

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

---------

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

* Resolve syncing conflicts from repo_sync_working_branch to main (#171)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#233)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](https://github.com/microsoftgraph/eol-blocker/compare/v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Resolve syncing conflicts from repo_sync_working_branch to main (#234)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

* live refresh (#232)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#169)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](https://github.com/microsoftgraph/eol-blocker/compare/v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

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

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

* live refresh (#232) (#237)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* 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



* chore: formatting issues
fix: invalid examples



* chore: more formatting



* docs: adds clarifications about $id and resources behaviour



* fix: property name



* docs: adds the page to the TOC



* docs: adds dynamic reference resolution example



* fix: path items references



* docs: updates which patterns are supported or not



---------




---------







---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* Resolve syncing conflicts from repo_sync_working_branch to main (#239)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

* live refresh (#232)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#169)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](https://github.com/microsoftgraph/eol-blocker/compare/v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

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

* Chore/live refresh (#238)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#233)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](https://github.com/microsoftgraph/eol-blocker/compare/v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Resolve syncing conflicts from repo_sync_working_branch to main (#234)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

* live refresh (#232)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#169)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](https://github.com/microsoftgraph/eol-blocker/compare/v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

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

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

* live refresh (#232) (#237)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* 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



* chore: formatting issues
fix: invalid examples



* chore: more formatting



* docs: adds clarifications about $id and resources behaviour



* fix: property name



* docs: adds the page to the TOC



* docs: adds dynamic reference resolution example



* fix: path items references



* docs: updates which patterns are supported or not



---------




---------







---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

* feat: adds support for external anchor and relative id (#167)

* feat: adds support for external anchor and relative id

* docs: adds support version for anchor

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

---------

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

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

* Chore/live refresh (#240)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#233)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](https://github.com/microsoftgraph/eol-blocker/compare/v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Resolve syncing conflicts from repo_sync_working_branch to main (#234)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

* live refresh (#232)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* chore(deps): bump microsoftgraph/eol-blocker from 1.0.14 to 1.0.15 (#169)

Bumps [microsoftgraph/eol-blocker](https://github.com/microsoftgraph/eol-blocker) from 1.0.14 to 1.0.15.
- [Release notes](https://github.com/microsoftgraph/eol-blocker/releases)
- [Commits](https://github.com/microsoftgraph/eol-blocker/compare/v1.0.14...v1.0.15)

---
updated-dependencies:
- dependency-name: microsoftgraph/eol-blocker
  dependency-version: 1.0.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

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

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service LearnBuild@microsoft.com>

* live refresh (#232) (#237)

* chore(deps): bump actions/checkout from 6 to 7 (#230)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* Confirm merge from repo_sync_working_branch to main to sync with https://github.com/microsoftdocs/openapi-docs (branch main) (#231)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* 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



* chore: formatting issues
fix: invalid examples



* chore: more formatting



* docs: adds clarifications about $id and resources behaviour



* fix: property name



* docs: adds the page to the TOC



* docs: adds dynamic reference resolution example



* fix: path items references



* docs: updates which patterns are supported or not



---------




---------







---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Darrel <darrmi@microsoft.com>

* Resolve syncing conflicts from repo_sync_working_branch to main (#239)

* chore(deps): bump actions/checkout from 6 to 7 (#166)

Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* 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 <vibire…
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

High-level documentation about "lossiness" of 3.0 to 2.0 downcasting

2 participants