Skip to content

chore: style guide update - #32815

Merged
MohamedH1998 merged 12 commits into
productionfrom
chore/style-guide-update
Aug 20, 2026
Merged

chore: style guide update#32815
MohamedH1998 merged 12 commits into
productionfrom
chore/style-guide-update

Conversation

@MohamedH1998

Copy link
Copy Markdown
Contributor

Summary

Restructures the Style Guide into clearer workflow-based sections for contributing, content planning, style and grammar, page building, and internal site operations. Adds new overview/navigation pages, consolidates related guidance, updates contributor references, and adds redirects for moved pages.

Screenshots (optional)

Documentation checklist

@MohamedH1998
MohamedH1998 requested review from a team and kodster28 as code owners August 18, 2026 06:00
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Aug 18, 2026

Copy link
Copy Markdown
Contributor

Review

Reviewing new changes (commit 4639dba)…


✅ No issues found in commit 1a34cfb.

Code Review

This code review is in beta and may not always be helpful — use your judgment.

No code review issues found.

Conventions

No convention issues found.

Style Guide Review

No style-guide issues found.

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command Description
/review Runs a review now. Incremental if a prior review exists, full if not.
/full-review Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.
/ignore-review-limit Permanently lifts the 2-review automatic limit for this PR. Future pushes will trigger reviews as normal.
/disable-auto-review Stops automatic reviews from triggering on future pushes to this PR. Codeowners can still run /review or /full-review manually.
/rebase Rebases the PR branch against production. On conflict, attempts to resolve automatically using AI. Stops with an explanation if confidence is not high enough.

@github-actions

Copy link
Copy Markdown
Contributor

This PR changes current filenames or deletes current files. Make sure you have redirects set up to cover the following paths:

  • /style-guide/components/anchor-heading/
  • /style-guide/components/api-request/
  • /style-guide/components/available-notifications/
  • /style-guide/components/badges/
  • /style-guide/components/buttons/
  • /style-guide/components/cards/
  • /style-guide/components/curl/
  • /style-guide/components/dash-button/
  • /style-guide/components/description/
  • /style-guide/components/details/
  • /style-guide/components/directory-listing/
  • /style-guide/components/example/
  • /style-guide/components/feature/
  • /style-guide/components/file-tree/
  • /style-guide/components/glossary-definition/
  • /style-guide/components/glossary-tooltip/
  • /style-guide/components/glossary/
  • /style-guide/components/icons/
  • /style-guide/components/inline-badge/
  • /style-guide/components/link-cards/
  • /style-guide/components/list-tutorials/
  • /style-guide/components/markdown/
  • /style-guide/components/package-managers/
  • /style-guide/components/pages-build-preset/
  • /style-guide/components/plan/
  • /style-guide/components/product-availability-text/
  • /style-guide/components/product-changelog/
  • /style-guide/components/public-stats/
  • /style-guide/components/related-product/
  • /style-guide/components/render/
  • /style-guide/components/resources-by-selector/
  • /style-guide/components/rss-button/
  • /style-guide/components/rule-id/
  • /style-guide/components/steps/
  • /style-guide/components/stream/
  • /style-guide/components/subtract-ip-calculator/
  • /style-guide/components/tabs/
  • /style-guide/components/type-highlighting/
  • /style-guide/components/typescript-example/
  • /style-guide/components/usage/
  • /style-guide/components/width/
  • /style-guide/components/wrangler-command/
  • /style-guide/components/wrangler-config/
  • /style-guide/components/wrangler-namespace/
  • /style-guide/components/youtube/
  • /style-guide/frontmatter/banner/
  • /style-guide/frontmatter/custom-properties/
  • /style-guide/frontmatter/
  • /style-guide/frontmatter/sidebar/
  • /style-guide/components/
  • /style-guide/documentation-content-strategy/component-attributes/context/
  • /style-guide/documentation-content-strategy/component-attributes/diagrams/
  • /style-guide/documentation-content-strategy/component-attributes/intended-audience/
  • /style-guide/documentation-content-strategy/component-attributes/introduction/
  • /style-guide/documentation-content-strategy/component-attributes/reference-diagram/
  • /style-guide/documentation-content-strategy/component-attributes/screenshots/
  • /style-guide/documentation-content-strategy/component-attributes/tables/
  • /style-guide/documentation-content-strategy/content-types/implementation-guide/
  • /style-guide/documentation-content-strategy/content-types/reference-architecture-diagram/
  • /style-guide/documentation-content-strategy/content-types/select-content-type/
  • /style-guide/documentation-content-strategy/content-types/solution-guide/

@github-actions

github-actions Bot commented Aug 18, 2026

Copy link
Copy Markdown
Contributor

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

Pattern Owners
* @cloudflare/product-owners
*.ts @cloudflare/content-engineering, @kodster28
/public/__redirects @cloudflare/content-engineering, @cloudflare/product-owners
/src/content/docs/style-guide/ @cloudflare/product-owners

@github-actions

github-actions Bot commented Aug 18, 2026

Copy link
Copy Markdown
Contributor

Preview URL: https://4639dbad.preview.developers.cloudflare.com
Preview Branch URL: https://chore-style-guide-update.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/ https://chore-style-guide-update.preview.developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/
https://developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/faq/ https://chore-style-guide-update.preview.developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/faq/
https://developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/3rd-party-integration-guide/ https://chore-style-guide-update.preview.developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/3rd-party-integration-guide/
https://developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/how-to/ https://chore-style-guide-update.preview.developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/how-to/
https://developers.cloudflare.com/style-guide/contributions/ https://chore-style-guide-update.preview.developers.cloudflare.com/style-guide/contributions/
https://developers.cloudflare.com/style-guide/documentation-content-strategy/component-attributes/tables/ https://chore-style-guide-update.preview.developers.cloudflare.com/style-guide/documentation-content-strategy/component-attributes/tables/
https://developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/overview/ https://chore-style-guide-update.preview.developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/overview/
https://developers.cloudflare.com/style-guide/documentation-content-strategy/component-attributes/images-and-diagrams/ https://chore-style-guide-update.preview.developers.cloudflare.com/style-guide/documentation-content-strategy/component-attributes/images-and-diagrams/
https://developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/reference-architecture/ https://chore-style-guide-update.preview.developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/reference-architecture/
https://developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/solution-guide/ https://chore-style-guide-update.preview.developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/solution-guide/
https://developers.cloudflare.com/style-guide/style-and-grammar/formatting/structure/tables/ https://chore-style-guide-update.preview.developers.cloudflare.com/style-guide/style-and-grammar/formatting/structure/tables/
https://developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/tutorial/ https://chore-style-guide-update.preview.developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/tutorial/
https://developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/configuration/ https://chore-style-guide-update.preview.developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/configuration/
https://developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/design-guide/ https://chore-style-guide-update.preview.developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/design-guide/
https://developers.cloudflare.com/style-guide/ https://chore-style-guide-update.preview.developers.cloudflare.com/style-guide/

@MohamedH1998
MohamedH1998 merged commit 27394ce into production Aug 20, 2026
14 checks passed
@MohamedH1998
MohamedH1998 deleted the chore/style-guide-update branch August 20, 2026 09:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants