[thetaPC]

Issue URL: internal

What is the current behavior?

The contributing guide and playground docs have drifted from the repo:

• The route table maps pages to src/pages/*.md, but content lives in docs/ as .mdx
• The Playground README's multi-file example passes a files prop that does not exist and leaves out version, so copying it renders nothing
• The generator docs say the playground path defaults to basic, but it has no default
• CI fails on missing heading IDs and old admonition titles, but the guide mentions neither
• The guide says the build both works and fails without a GitHub token

What is the new behavior?

CONTRIBUTING.md

• The route table points at real files, including a v8 row
• Explains that versions in versions.json are maintained, and that changes to archived version folders never reach the site
• Notes that JSX paths in older versions need the version prefix, such as /v8/
• New sections: Checking Links, Heading IDs, Admonitions, and Playgrounds
• Asks for Conventional Commits PR titles
• Corrects the GitHub token, Windows, Directories, and Reference Content sections

Playground docs

• Playground README: working examples, an options table, and how to add StackBlitz dependencies
• Template README: lists the generator's four prompts

Does this introduce a breaking change?

• Yes
• No

Other information

N/A

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
ionic-docs	Ready	Preview	Nov 4, 2026 10:59pm UTC

[OS-jacobbell]

LGTM