chore: auto formatter

[MohamedH1998]

Summary

Adopts Prettier formatting across the MD/MDX/Astro content tree

Screenshots (optional)

Documentation checklist

• Is there a changelog entry (guidelines)? If you don't add one for something awesome and new (however small) — how will our customers find out? Changelogs are automatically posted to RSS feeds, the Discord, and X.
• The change adheres to the documentation style guide.
• If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
• Files which have changed name or location have been allocated redirects.

---

[github-actions]

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern	Owners
*	@cloudflare/product-owners
/.github/	@cloudflare/content-engineering, @kodster28, @mvvmm, @colbywhite, @ahaywood, @MohamedH1998
package.json	@cloudflare/content-engineering
*.astro	@cloudflare/content-engineering, @kodster28
/src/content/catalog-models/	@abhishekkankani, @palashgo, @thebongy, @roerohan, @kathayl, @mchenco, @zeke, @superhighfives, @bfirsh, @mattrothenberg, @ethulia, @cloudflare/content-engineering, @cloudflare/product-owners
/src/content/changelog/	@cloudflare/pm-changelogs, @cloudflare/product-owners
/src/content/compatibility-flags/	@irvinebroque, @mikenomitch, @GregBrimble, @cloudflare/product-owners, @MattieTK
/src/content/docs/logs/	@soheiokamoto, @angelampcosta, @rianvdm, @dcpena, @cloudflare/product-owners
/src/content/docs/realtime/	@cloudflare/product-owners, @cloudflare/realtime, @cloudflare/RealtimeKit, @roerohan, @ravindra-cloudflare
/src/content/docs/support/	@cloudflare/product-owners, @cloudflare/customer-support, @ngayerie, @krys-cf, @stechedo, @zeinjaber, @shanecloudflare
/src/content/release-notes/beacon-min-js.yaml	@angelampcosta, @dcpena, @ryantownsend, @cloudflare/product-owners

[ask-bonk]

pnpm run format:check currently fails. 3 issues need fixing before merge.

• CRITICAL: pnpm run format:check fails on 8 files — 7 MDX files merged from production are unformatted, and .opencode/package.json is not ignored. Run pnpm run format and add .opencode/ to .prettierignore.
• HIGH: Example.astro and PageTitle.astro convert conditional <style> blocks to <style set:html>. This removes Astro's default style scoping, making those styles global. Verify this is intentional.
• MEDIUM: ~60 files in .prettierignore under "Deferred follow-up work" lack a tracking issue or plan. The previous ignore list referenced FORMATTING-PLAN.md, which no longer exists. Consider creating a follow-up issue to track these.

[ask-bonk]

Labels applied: docs engine, documentation.

Summary

PR #31018 adopts Prettier formatting across the MD/MDX/Astro content tree. It:

• Expands .prettierrc.mjs with additional mdxPreserveElements and disables embeddedLanguageFormatting for Markdown and MDX.
• Collapses package.json format scripts into a single format / format:check command covering all extensions.
• Updates CI to run the unified format check.
• Formats ~3,100 files and fixes Astro/JSX parse errors in several previously ignored components (e.g., adding fragments, replacing HTML comments with JSX comments).

Issues flagged

I posted a review with 4 inline comments. Key issues requiring maintainer attention:

• CRITICAL: pnpm run format:check currently fails on 8 files. Seven MDX files were merged unformatted from production after the last format pass, and .opencode/package.json is not ignored by Prettier. Needs a fresh pnpm run format pass and .opencode/ added to .prettierignore.
• HIGH: Semantic change in Example.astro and PageTitle.astro. Conditional <style> blocks were converted to <style set:html>, which removes Astro's default style scoping and makes those styles global. Confirm this is intentional.
• MEDIUM: The .prettierignore "Deferred follow-up work" list contains ~60 files with no tracking issue or document. The old ignore list referenced FORMATTING-PLAN.md, which no longer exists. Recommend opening a follow-up issue to track these.

No commits were pushed.

github run

[MohamedH1998]

/bonk review

[ask-bonk]

Previous issues addressed: CI enforcement reverted, Example.astro and PageTitle.astro restored to scoped <style> blocks. 2 new issues need fixing before merge.

CRITICAL: .opencode/ missing from .prettierignore
pnpm run format:data attempts to format generated files under .opencode/ (e.g., .opencode/package.json). These files should be ignored.

HIGH: Unnecessary "Deferred follow-up work" entries
I batch-checked every file in this section — Example.astro, PageTitle.astro, and all 65 MDX files — and Prettier parses and formats every one of them correctly. None need to be ignored. Remove the entire block so future edits are checked.

No build, type, lint, or test regressions found.

[ask-bonk]

Posted a review on PR #31018 with 2 inline comments.

What I found

• Previous issues were addressed: CI enforcement was reverted and Example.astro/PageTitle.astro were restored to proper scoped <style> blocks.
• Validation passed: pnpm run check, pnpm run lint, pnpm run test:prebuild, format:core:check, and prettier --check for MDX/Astro all succeed.

New issues flagged

1. CRITICAL: .opencode/ is missing from .prettierignore. I verified that .opencode/package.json is unformatted and would be touched by pnpm run format:data.
2. HIGH: The entire "Deferred follow-up work" section in .prettierignore is unnecessary. I batch-checked every file in that section — all 65 MDX files plus Example.astro and PageTitle.astro — and Prettier parses and formats every one of them correctly. None need to remain ignored.

Review link: #31018 (review)

github run

[github-actions]

Preview URL: https://e8371d53.preview.developers.cloudflare.com
Preview Branch URL: https://chore-auto-formatter.preview.developers.cloudflare.com

[MohamedH1998]

/bonk review

[ask-bonk]

Fixed the remaining .opencode/ ignore issue. No other blockers found.

CRITICAL (fixed): Added .opencode/ to .prettierignore to prevent format:data from touching generated agent files.

Validation passed:

• pnpm run check ✅
• pnpm run lint ✅
• pnpm run format:core:check ✅
• pnpm run test:prebuild ✅

[ask-bonk]

Posted a review on PR #31018.

What changed

• Fixed .prettierignore — added .opencode/ so that pnpm run format:data won't touch generated agent files under .opencode/. This was the last remaining blocker from the previous review round.

Validation

All checks pass after the fix:

• pnpm run check ✅
• pnpm run lint ✅
• pnpm run format:core:check ✅
• pnpm run test:prebuild ✅

No other issues found. Ready for merge once the auto-push completes.

github run