Thanks to visit codestin.com
Credit goes to github.com

Skip to content

feat: adds support for external anchor and relative id - #167

Merged
Vincent Biret (baywet) merged 3 commits into
mainfrom
feat/external-anchor-relative-id
Jul 15, 2026
Merged

Vincent Biret (baywet) merged 3 commits into
mainfrom
feat/external-anchor-relative-id

Conversation

@baywet

Copy link
Copy Markdown
Member

follow up to #145

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 0d65d84:

✅ Validation status: passed

File Status Preview URL Details
OpenAPI/OpenAPI.NET/references-openapi.md ✅Succeeded

For more details, please refer to the build report.

@aqeelat

Copy link
Copy Markdown
Contributor

Vincent Biret (@baywet) Great to see this documentation published. The taxonomy of Reference Objects vs JSON Schema $ref is the right framing.

A few observations on the broader page (not specific to this PR's diff):

1. Missing: $ref siblings in 3.1

The biggest gap. OpenAPI 3.0 ignores siblings next to $ref; 3.1 allows them and they take precedence over target values via the existing Reference.X ?? Target?.X getters. Users transitioning from 3.0 to 3.1 need to know this. It belongs in the "JSON Schema $refs in OpenAPI descriptions" section.

2. Version comparison table

A quick-reference table showing what's supported across 3.0 / 3.1 / 3.2 would help users scanning for their target version: $ref siblings, $anchor resolution, $dynamicRef/$dynamicAnchor, relative $id, external fragments, etc.

3. $dynamicAnchor/$dynamicRef section header

The body text is accurate ("exposed as properties... but dynamic reference resolution is not currently implemented"), but the section header [Not currently supported] is misleading. It implies the keywords aren't handled at all. Since #2896, they're fully parsed, stored, and round-tripped through serialization. Consider [Resolution not yet implemented] or similar to distinguish from "not supported at all." This section will also need updating once #2913 (resolution) merges.

@baywet

Copy link
Copy Markdown
Member Author

Thank you for the comments!

  1. Missing: $ref siblings in 3.1

Would you mind starting a PR to address this please?

@aqeelat

Copy link
Copy Markdown
Contributor

Thank you for the comments!

  1. Missing: $ref siblings in 3.1

Would you mind starting a PR to address this please?

Vincent Biret (@baywet) I was gonna, but then discovered another issue (microsoft/OpenAPI.NET#2919).

Ya know, I'll still open the PR as draft, with the current status, and include in the description what will change once the issue is addressed.

@baywet
Vincent Biret (baywet) force-pushed the feat/external-anchor-relative-id branch from 0d65d84 to f01ab39 Compare July 15, 2026 16:24
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit f01ab39:

✅ Validation status: passed

File Status Preview URL Details
OpenAPI/OpenAPI.NET/references-openapi.md ✅Succeeded

For more details, please refer to the build report.

@baywet
Vincent Biret (baywet) marked this pull request as ready for review July 15, 2026 16:27
@baywet
Vincent Biret (baywet) requested a review from a team as a code owner July 15, 2026 16:27
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 877d002:

✅ Validation status: passed

File Status Preview URL Details
OpenAPI/OpenAPI.NET/references-openapi.md ✅Succeeded

For more details, please refer to the build report.

@baywet
Vincent Biret (baywet) enabled auto-merge (squash) July 15, 2026 16:27
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit ab68318:

✅ Validation status: passed

File Status Preview URL Details
OpenAPI/OpenAPI.NET/references-openapi.md ✅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
Vincent Biret (baywet) merged commit e43250f into main Jul 15, 2026
3 checks passed
@baywet
Vincent Biret (baywet) deleted the feat/external-anchor-relative-id branch July 15, 2026 16:44
@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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

* 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] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

* 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] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>

* 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 <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

* 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] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>

* 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 <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>
Jason Johnston (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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

* 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] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

* 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] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>

* 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 <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

* 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] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

* 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] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>

* 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 <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>
Co-authored-by: Darrel <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Servi…
Vincent Biret (baywet) pushed a commit that referenced this pull request Jul 15, 2026
…ce (#168)

- Add section explaining $ref sibling behavior in OpenAPI 3.1 vs 3.0
- Document OpenApiSchemaReference.Target and Reference access patterns
- Update $dynamicRef section: resolution now implemented
- Note $anchor fallback alongside $dynamicAnchor resolution
- Add version notes (siblings: 3.8.0/2.10.0, dynamicRef: 3.9.0/2.11.0)

Follow-up to #167
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

* 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] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>

* 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 <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

* 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] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

* 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] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>

* 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 <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

* 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] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <vibire…
learn-build-service-prod Bot added a commit that referenced this pull request Aug 11, 2026
…s://github.com/microsoftdocs/openapi-docs (branch main) (#247)

* 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](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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

* 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] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

* 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] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>

* 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 <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>

* Initialize Docs repository: https://github.com/MicrosoftDocs/openapi-docs-pr of branch live

* docs(kiota): document scrubbing custom sensitive headers on redirects (#172)

* docs(kiota): document scrubbing custom sensitive headers on redirects

* docs(kiota): add TypeScript tab to fix tab group id warning

Co-authored-by: Copilot <[email protected]>
Copilot-Session: 491d68b0-7a24-4232-8f74-20c999805600

---------

Co-authored-by: Treicy Sanchez Gutierrez (from Dev Box) <[email protected]>
Co-authored-by: Copilot <[email protected]>
Copilot-Session: 491d68b0-7a24-4232-8f74-20c999805600

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
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 <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Jason Johnston <[email protected]>
Co-authored-by: jasonjoh <[email protected]>
Co-authored-by: Treicy Sanchez <[email protected]>
Co-authored-by: Treicy Sanchez Gutierrez (from Dev Box) <[email protected]>
Co-authored-by: Copilot <[email protected]>
Copilot-Session: 491d68b0-7a24-4232-8f74-20c999805600
learn-build-service-prod Bot added a commit that referenced this pull request Aug 26, 2026
…s://github.com/microsoftdocs/openapi-docs (branch main) (#250)

* 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](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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

* 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] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

* 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] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>

* 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 <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>

* Initialize Docs repository: https://github.com/MicrosoftDocs/openapi-docs-pr of branch live

* docs(kiota): document scrubbing custom sensitive headers on redirects (#172)

* docs(kiota): document scrubbing custom sensitive headers on redirects

* docs(kiota): add TypeScript tab to fix tab group id warning

Co-authored-by: Copilot <[email protected]>
Copilot-Session: 491d68b0-7a24-4232-8f74-20c999805600

---------

Co-authored-by: Treicy Sanchez Gutierrez (from Dev Box) <[email protected]>
Co-authored-by: Copilot <[email protected]>
Copilot-Session: 491d68b0-7a24-4232-8f74-20c999805600

* docs(kiota): add TypeScript example for scrubbing custom headers on redirects (#173)

Co-authored-by: Treicy Sanchez Gutierrez (from Dev Box) <[email protected]>
Co-authored-by: Copilot <[email protected]>
Copilot-Session: 491d68b0-7a24-4232-8f74-20c999805600

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
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 <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Jason Johnston <[email protected]>
Co-authored-by: jasonjoh <[email protected]>
Co-authored-by: Treicy Sanchez <[email protected]>
Co-authored-by: Treicy Sanchez Gutierrez (from Dev Box) <[email protected]>
Co-authored-by: Copilot <[email protected]>
Copilot-Session: 491d68b0-7a24-4232-8f74-20c999805600
learn-build-service-prod Bot added a commit that referenced this pull request Sep 8, 2026
…s://github.com/microsoftdocs/openapi-docs (branch main) (#252)

* 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](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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

* 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] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

* 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] <[email protected]>
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] <[email protected]>
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 <[email protected]>

* chore: formatting issues
fix: invalid examples

Signed-off-by: Vincent Biret <[email protected]>

* chore: more formatting

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds clarifications about $id and resources behaviour

Signed-off-by: Vincent Biret <[email protected]>

* fix: property name

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds the page to the TOC

Signed-off-by: Vincent Biret <[email protected]>

* docs: adds dynamic reference resolution example

Signed-off-by: Vincent Biret <[email protected]>

* fix: path items references

Signed-off-by: Vincent Biret <[email protected]>

* docs: updates which patterns are supported or not

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>

---------

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

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

* 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] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* docs: adds conversions trade off (#170)

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

* 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] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>

* 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 <[email protected]>

---------

Signed-off-by: Vincent Biret <[email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Darrel <[email protected]>
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 [email protected]>

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
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 <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>

* Initialize Docs repository: https://github.com/MicrosoftDocs/openapi-docs-pr of branch live

* docs(kiota): document scrubbing custom sensitive headers on redirects (#172)

* docs(kiota): document scrubbing custom sensitive headers on redirects

* docs(kiota): add TypeScript tab to fix tab group id warning

Co-authored-by: Copilot <[email protected]>
Copilot-Session: 491d68b0-7a24-4232-8f74-20c999805600

---------

Co-authored-by: Treicy Sanchez Gutierrez (from Dev Box) <[email protected]>
Co-authored-by: Copilot <[email protected]>
Copilot-Session: 491d68b0-7a24-4232-8f74-20c999805600

* docs(kiota): add TypeScript example for scrubbing custom headers on redirects (#173)

Co-authored-by: Treicy Sanchez Gutierrez (from Dev Box) <[email protected]>
Co-authored-by: Copilot <[email protected]>
Copilot-Session: 491d68b0-7a24-4232-8f74-20c999805600

* Pin GitHub Actions to full-length commit SHAs (#174)

---------

Signed-off-by: dependabot[bot] <[email protected]>
Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: Vincent Biret <[email protected]>
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 <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Jason Johnston <[email protected]>
Co-authored-by: jasonjoh <[email protected]>
Co-authored-by: Treicy Sanchez <[email protected]>
Co-authored-by: Treicy Sanchez Gutierrez (from Dev Box) <[email protected]>
Co-authored-by: Copilot <[email protected]>
Co-authored-by: Dan Fiedler <[email protected]>
Copilot-Session: 491d68b0-7a24-4232-8f74-20c999805600
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.

3 participants