Skip to content

Rework of the xml docs#10047

Merged
timotheeguerin merged 13 commits into
microsoft:mainfrom
timotheeguerin:xml-docs-fix
Apr 1, 2026
Merged

Rework of the xml docs#10047
timotheeguerin merged 13 commits into
microsoft:mainfrom
timotheeguerin:xml-docs-fix

Conversation

@timotheeguerin
Copy link
Copy Markdown
Member

@timotheeguerin timotheeguerin commented Mar 16, 2026

fix #10022

@microsoft-github-policy-service microsoft-github-policy-service Bot added the meta:website TypeSpec.io updates label Mar 16, 2026
@github-actions
Copy link
Copy Markdown
Contributor

No changes needing a change description found.

@azure-sdk
Copy link
Copy Markdown
Collaborator

azure-sdk commented Mar 16, 2026

You can try these changes here

🛝 Playground 🌐 Website 🛝 VSCode Extension

Comment thread website/src/content/docs/docs/libraries/xml/guide.mdx Outdated
Copy link
Copy Markdown
Member

@lmazuel lmazuel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed the array part, LGTM

Copy link
Copy Markdown
Member

@catalinaperalta catalinaperalta left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm, this clarifies a lot of the xml behavior in typespec, the specific examples are really helpful. Same as Laurent mentioned, just to be extra sure to avoid confusion all property and target model names should be different so the docs are clear and easier to understand.

@timotheeguerin timotheeguerin marked this pull request as ready for review March 17, 2026 03:37
@timotheeguerin timotheeguerin added this pull request to the merge queue Apr 1, 2026
Merged via the queue into microsoft:main with commit e22670a Apr 1, 2026
38 checks passed
@timotheeguerin timotheeguerin deleted the xml-docs-fix branch April 1, 2026 19:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

meta:website TypeSpec.io updates

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Xml inconsistency

5 participants