Skip to content

Document unified example authoring and working editor schema - #5801

Closed
Timothee Guerin (timotheeguerin) wants to merge 1 commit into
Azure:mainfrom
timotheeguerin:docs/unified-example-authoring
Closed

Timothee Guerin (timotheeguerin) wants to merge 1 commit into
Azure:mainfrom
timotheeguerin:docs/unified-example-authoring

Conversation

@timotheeguerin

Copy link
Copy Markdown
Member

Contributors currently get a 404 from the advertised editor schema and lack a single guide for creating, changing, versioning, and migrating unified examples.

Use the version-pinned JSON Schema artifact that is already published in the npm package, with a YAML language-server modeline. Centralized guidance explains operation keys, filename IDs versus title-based lineages, since, generated artifacts, migration round-trip checks, editor support, and validation guarantees. Commands are explicitly qualified by installed CLI capabilities so examples 0.2.1 users are not told that unreleased commands are available.

Fixes #5794.

Documentation-only, targeting main. Package fixes remain in release-targeted PRs #5799 and #5800.

@pkg-pr-new

pkg-pr-new Bot commented Oct 21, 2026

Copy link
Copy Markdown

Open in StackBlitz

npm i https://pkg.pr.new/@azure-tools/typespec-azure-examples@5801

commit: ce33033

@github-actions

Copy link
Copy Markdown
Contributor

No changes needing a change description found.

@github-actions

Copy link
Copy Markdown
Contributor

📦 Package size report

1 package changed size, +1.89 KB (+0.0%) packed overall.

Package Packed (base → head) Δ Packed Unpacked (base → head) Δ Unpacked
@azure-tools/typespec-azure-examples 80.15 KB → 82.04 KB +1.89 KB (+2.4%) 🔴 383.36 KB → 388.64 KB +5.28 KB (+1.4%) 🔴
13 package(s) with no notable change
Package Packed (base → head) Δ Packed Unpacked (base → head) Δ Unpacked
@azure-tools/azure-http-specs 143.53 KB → 143.53 KB — 1.20 MB → 1.20 MB —
@azure-tools/typespec-autorest 87.87 KB → 87.87 KB — 424.17 KB → 424.17 KB —
@azure-tools/typespec-autorest-canonical 7.42 KB → 7.42 KB — 26.00 KB → 26.00 KB —
@azure-tools/typespec-azure-core 136.55 KB → 136.55 KB — 733.30 KB → 733.30 KB —
@azure-tools/typespec-azure-portal-core 36.26 KB → 36.26 KB — 242.62 KB → 242.62 KB —
@azure-tools/typespec-azure-resource-manager 192.89 KB → 192.89 KB — 1.15 MB → 1.15 MB —
@azure-tools/typespec-azure-rulesets 6.00 KB → 6.00 KB — 35.20 KB → 35.20 KB —
@azure-tools/typespec-client-generator-core 248.86 KB → 248.86 KB — 1.32 MB → 1.32 MB —
@azure-tools/typespec-go 264.28 KB → 264.28 KB — 1.35 MB → 1.35 MB —
@azure-tools/typespec-java 20.22 MB → 20.22 MB — 22.52 MB → 22.52 MB —
@azure-tools/typespec-metadata 15.88 KB → 15.88 KB — 62.08 KB → 62.08 KB —
@azure-tools/typespec-python 42.58 KB → 42.58 KB — 166.02 KB → 166.02 KB —
@azure-tools/typespec-ts 550.66 KB → 550.66 KB — 2.75 MB → 2.75 MB —

Packed = gzipped .tgz published to npm. Unpacked = total extracted size. 🆕 added, 🗑️ removed. Packages from the core/ submodule are not included.
🔴 grew · 🟢 shrank — only changes of at least 512 B and 0.5% are marked.

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.

Provide working editor schema and unified example authoring guidance

1 participant