Skip to content

Migrate docs callouts and cleanup translations#3630

Open
fellyph wants to merge 4 commits into
trunkfrom
docs/migration
Open

Migrate docs callouts and cleanup translations#3630
fellyph wants to merge 4 commits into
trunkfrom
docs/migration

Conversation

@fellyph
Copy link
Copy Markdown
Collaborator

@fellyph fellyph commented May 13, 2026

What changed

  • Replaced active Docusaurus admonition directives in English docs and translations with WordPress Handbook raw HTML callouts.
  • Removed remaining translated heading IDs and fragment component references.
  • Converted links inside touched raw callouts to HTML anchors.
  • Added a local .callout-tip fallback style for Docusaurus rendering.

Validation

  • rg '\{#[^}]+\}' packages/docs/site/docs packages/docs/site/i18n -g '*.md' -g '*.mdx'
  • rg '(_fragments|<APIList|<ThisIsQueryApi|PlaygroundWpNetWarning|JSApiShortExample)' packages/docs/site/docs packages/docs/site/i18n -g '*.md' -g '*.mdx'
  • rg '^\s*:{3,}' packages/docs/site/docs packages/docs/site/i18n -g '*.md' -g '*.mdx'
  • npm exec nx run docs-site:build

Note: docs-site:build succeeds, with existing Docusaurus broken-anchor warnings still reported across locales.

@fellyph fellyph requested review from a team, Copilot and mho22 May 13, 2026 15:46
@github-actions github-actions Bot added the [Type] Documentation Improvements or additions to documentation label May 13, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Migrates Docusaurus admonitions (and related translation artifacts) to WordPress Handbook–style raw HTML callouts across the English docs and multiple locales, plus a small CSS addition to keep callouts readable in Docusaurus.

Changes:

  • Replaced :::tip/info/caution/warning/danger blocks with <div class="callout ..."> equivalents across docs and translations.
  • Removed remaining translated heading IDs / fragment component references and converted links inside raw callouts to HTML anchors.
  • Added a local .callout-tip background fallback in the docs site CSS.

Reviewed changes

Copilot reviewed 195 out of 196 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
packages/docs/site/src/css/custom.css Adds a .callout-tip background variable to improve callout rendering in Docusaurus.
packages/docs/site/i18n/tl/docusaurus-plugin-content-docs/current/main/web-instance.md Converts warning admonitions to raw HTML callouts and converts links inside callouts to <a>.
packages/docs/site/i18n/tl/docusaurus-plugin-content-docs/current/main/intro.md Converts tip admonitions and key links to HTML compatible with raw callouts.
packages/docs/site/i18n/tl/docusaurus-plugin-content-docs/current/main/guides/providing-content-for-your-demo.md Converts tip admonition to raw HTML callout and updates links to <a>.
packages/docs/site/i18n/tl/docusaurus-plugin-content-docs/current/main/contributing/translations.md Converts links inside callouts to HTML anchors.
packages/docs/site/i18n/tl/docusaurus-plugin-content-docs/current/main/contributing/contributor-day.md Converts link inside callout to HTML anchor.
packages/docs/site/i18n/tl/docusaurus-plugin-content-docs/current/main/about/launch.md Converts link inside callout to HTML anchor.
packages/docs/site/i18n/tl/docusaurus-plugin-content-docs/current/main/about/index.md Normalizes list formatting and converts tip admonition to raw HTML callout.
packages/docs/site/i18n/tl/docusaurus-plugin-content-docs/current/blueprints/tutorial/index.md Converts tip admonition to raw HTML callout and updates internal link to <a>.
packages/docs/site/i18n/tl/docusaurus-plugin-content-docs/current/blueprints/tutorial/03-build-your-first-blueprint.md Converts tip/note admonitions to raw HTML callouts and updates links to <a>.
packages/docs/site/i18n/tl/docusaurus-plugin-content-docs/current/blueprints/tutorial/01-what-are-blueprints-what-you-can-do-with-them.md Converts resource links list to HTML anchors for compatibility with raw callouts.
packages/docs/site/i18n/tl/docusaurus-plugin-content-docs/current/blueprints/07-json-api-and-function-api.md Converts links inside callouts to <a> and replaces note with raw HTML callout.
packages/docs/site/i18n/tl/docusaurus-plugin-content-docs/current/blueprints/02-using-blueprints.md Converts tips to raw HTML callouts and converts linked code references to <a><code>.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/web-instance.md Converts warning admonitions to raw HTML callouts and updates links to <a>.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/resources.md Converts tips to raw HTML callouts (including commented blocks).
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/quick-start-guide.md Converts (commented) info admonitions to raw HTML callouts with explicit titles.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/intro.md Converts callouts to raw HTML and replaces fragment component usage with explicit lists.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/providing-content-for-your-demo.md Converts tips to raw HTML callouts and updates links to <a>.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/playground-for-everyone.md Converts (commented and active) callouts to raw HTML with explicit titles.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/contributing/contributor-day.md Converts (commented and active) callouts to raw HTML and updates links to <a>.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/contributing/code.md Converts (commented) callouts to raw HTML with explicit titles.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/about/launch.md Converts links inside callouts to <a> (including commented block).
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/about/index.md Normalizes list formatting and converts tips to raw HTML callouts.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/about/build.md Converts (commented) info admonition to raw HTML callout.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md Converts tip admonition to raw HTML callout.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/23-architecture/18-host-your-own-playground.md Converts source-file link in callout to <a>.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/06-apis/query-api/01-index.md Converts CORS reference links inside callout to <a>.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/06-apis/javascript-api/01-index.md Converts inline link in callout to <a>.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/05-local-development/04-wp-playground-cli.md Converts multiple (commented and active) admonitions to raw HTML callouts.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/05-local-development/02-vscode-extension.md Converts links in doc callout and commented block to <a>.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/05-local-development/01-wp-now.md Converts warning admonition and doc links to raw HTML callouts/anchors.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md Converts caution/tip admonitions to raw HTML callouts and updates links to <a>.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/blueprints/tutorial/index.md Converts tips (commented and active) to raw HTML callouts.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/blueprints/tutorial/03-build-your-first-blueprint.md Converts tip/note admonitions to raw HTML callouts and updates links.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/blueprints/tutorial/01-what-are-blueprints-what-you-can-do-with-them.md Converts resource list links to <a> compatible with raw HTML sections.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/blueprints/intro.md Converts tips to raw HTML callouts and updates gallery link to <a>.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/blueprints/08-examples.md Converts tip/note admonitions to raw callouts and normalizes some comment indentation.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/blueprints/07-json-api-and-function-api.md Converts note to info callout and updates links to <a>.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/blueprints/05-steps.md Converts step-library tip admonition to raw HTML callout.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/blueprints/05-steps-shorthands.md Converts (commented) info admonition to raw HTML callout.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/blueprints/04-resources.md Converts links inside callout content (including commented English) to <a><code>.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/main/web-instance.md Converts warning admonitions to raw HTML callouts and updates links.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/main/resources.md Converts tips to raw HTML callouts.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/main/quick-start-guide.md Converts (commented) info admonitions to raw HTML callouts with explicit titles.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/main/intro.md Converts tips/info blocks to raw HTML callouts and replaces fragment component usage with explicit lists.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/main/guides/providing-content-for-your-demo.md Converts tips (including commented English) to raw HTML callouts and updates links to <a>.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/main/contributing/translations.md Converts links inside callouts (including commented English) to <a>.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/main/contributing/contributor-day.md Converts links in callouts (including commented English) to <a>.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/main/contributing/code.md Converts (commented) callouts to raw HTML callouts with explicit titles.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/main/about/launch.md Converts links in callouts (including commented English) to <a>.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/main/about/index.md Normalizes list formatting and converts tips (including commented English) to raw HTML callouts.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/main/about/build.md Converts (commented) info admonition to raw HTML callout.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md Converts tips (including commented English) to raw HTML callouts.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/developers/23-architecture/10-browser-iframe-rendering.md Converts callout links to <a> and converts commented info admonition to raw HTML callout.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/developers/06-apis/query-api/01-index.md Converts CORS info block to raw HTML callout and updates reference link to <a>.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/developers/06-apis/javascript-api/01-index.md Converts info blocks to raw HTML callouts and updates internal links to <a>.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/developers/05-local-development/04-wp-playground-cli.md Converts multiple (commented and active) admonitions to raw HTML callouts.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/developers/05-local-development/03-php-wasm-node.md Converts API reference callout + commented info block to raw HTML equivalents.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/developers/05-local-development/02-vscode-extension.md Converts documentation callout + commented info block to raw HTML equivalents.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/developers/05-local-development/01-wp-now.md Converts warning/info blocks (including commented English) to raw HTML callouts.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md Converts caution admonition to raw HTML callout and updates link to <a>.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/blueprints/tutorial/index.md Converts tips (including commented English) to raw HTML callouts.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/blueprints/tutorial/03-build-your-first-blueprint.md Converts tip/note blocks to raw HTML callouts and updates links within callouts.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/blueprints/tutorial/01-what-are-blueprints-what-you-can-do-with-them.md Converts resource list links to <a> and converts commented info admonition to raw HTML callout.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/blueprints/08-examples.md Converts tips to raw HTML callouts and normalizes list formatting.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/blueprints/07-json-api-and-function-api.md Converts info/note blocks to raw HTML callouts and updates links to <a>.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/blueprints/05-steps.md Converts tip blocks (including commented English) to raw HTML callouts and adjusts list indentation.
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/blueprints/05-steps-shorthands.md Converts (commented) info admonition to raw HTML callout.
packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/translations.md Converts (commented and active) info blocks to raw HTML callouts and updates links to <a>.
packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/contributor-day.md Converts an info admonition and updates links in callouts to <a>.
packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/contributing/code.md Converts (commented) info blocks to raw HTML callouts and updates internal links to <a>.
packages/docs/site/i18n/gu/docusaurus-plugin-content-docs/current/main/web-instance.md Converts warning admonitions to raw HTML callouts and updates links to <a>.
packages/docs/site/i18n/gu/docusaurus-plugin-content-docs/current/main/intro.md Converts key link and tip admonition to raw HTML callout and anchors.
packages/docs/site/i18n/gu/docusaurus-plugin-content-docs/current/main/contributing/contributor-day.md Converts links inside callout to <a> (including commented English).
packages/docs/site/i18n/gu/docusaurus-plugin-content-docs/current/main/contributing/code.md Converts (commented) info blocks to raw HTML callouts and updates internal links to <a>.
packages/docs/site/i18n/gu/docusaurus-plugin-content-docs/current/main/about/launch.md Converts links in callouts (including commented English) to <a>.
packages/docs/site/i18n/gu/docusaurus-plugin-content-docs/current/main/about/index.md Normalizes list formatting and converts tip admonition to raw HTML callout.
packages/docs/site/i18n/gu/docusaurus-plugin-content-docs/current/main/about/build.md Converts (commented) info admonition to raw HTML callout.
packages/docs/site/i18n/gu/docusaurus-plugin-content-docs/current/developers/05-local-development/03-php-wasm-node.md Converts API reference callout + commented info block to raw HTML equivalents.
packages/docs/site/i18n/gu/docusaurus-plugin-content-docs/current/developers/05-local-development/02-vscode-extension.md Converts documentation callout + commented info block to raw HTML equivalents.
packages/docs/site/i18n/gu/docusaurus-plugin-content-docs/current/developers/05-local-development/01-wp-now.md Converts warning/info blocks (including commented English) to raw HTML callouts.
packages/docs/site/i18n/gu/docusaurus-plugin-content-docs/current/blueprints/tutorial/index.md Converts tips (including commented English) to raw HTML callouts.
packages/docs/site/i18n/gu/docusaurus-plugin-content-docs/current/blueprints/tutorial/01-what-are-blueprints-what-you-can-do-with-them.md Converts resource list links to <a> and converts commented info block to raw HTML callout.
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/main/resources.md Converts tip admonition to raw HTML callout.
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/main/guides/playground-for-everyone.md Converts (commented and active) callouts to raw HTML with explicit titles.
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/main/guides/index.md Converts profile links to anchors and adjusts callout HTML structure.
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/main/contributing/translations.md Converts (commented) info blocks to raw HTML callouts and updates links to <a>.
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/main/about/launch.md Converts link inside callout to <a>.
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md Converts tip admonition to raw HTML callout.
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/23-architecture/18-host-your-own-playground.md Converts source-file link in callout to <a>.
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/06-apis/query-api/01-index.md Converts CORS reference links inside callout to <a>.
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md Converts caution admonition to raw HTML callout and updates translator profile link to <a>.
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/blueprints/tutorial/index.md Converts tip admonition and profile links to HTML anchors.
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/blueprints/tutorial/03-build-your-first-blueprint.md Converts tip/note blocks to raw HTML callouts and updates profile links.
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/blueprints/08-examples.md Converts tip/note blocks to raw HTML callouts and updates profile links to <a>.
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/main/web-instance.md Converts warning admonitions to raw HTML callouts and updates links.
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/main/resources.md Converts tips to raw HTML callouts (including commented blocks).
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/main/quick-start-guide.md Converts (commented) info admonitions to raw HTML callouts with explicit titles.
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/main/intro.md Converts info/tip blocks to raw HTML callouts and updates links to <a>.
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/main/guides/playground-for-everyone.md Converts (commented and active) tips/info blocks to raw HTML callouts with explicit titles.
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/main/contributing/translations.md Converts (commented and active) info blocks to raw HTML callouts and updates links to <a>.
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/main/contributing/code.md Converts (commented) info blocks to raw HTML callouts with explicit titles.
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/main/about/build.md Converts (commented) info admonition to raw HTML callout.
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md Converts tip admonition to raw HTML callout.
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/23-architecture/18-host-your-own-playground.md Converts source-file link in callout to <a>.
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/06-apis/query-api/01-index.md Converts CORS reference links inside callout to <a>.
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/05-local-development/04-wp-playground-cli.md Converts multiple (commented and active) admonitions to raw HTML callouts.
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md Converts caution/tip admonitions to raw HTML callouts and updates links to <a>.
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/blueprints/08-examples.md Converts tip/note blocks to raw HTML callouts and normalizes some comment indentation.
packages/docs/site/i18n/bn/docusaurus-plugin-content-docs/current/main/web-instance.md Converts caution blocks to callouts (including commented English) and updates links partially.
packages/docs/site/i18n/bn/docusaurus-plugin-content-docs/current/main/resources.md Converts tips to raw HTML callouts (including commented blocks).
packages/docs/site/i18n/bn/docusaurus-plugin-content-docs/current/main/quick-start-guide.md Converts (commented and active) info blocks to raw HTML callouts with explicit titles.
packages/docs/site/i18n/bn/docusaurus-plugin-content-docs/current/main/intro.md Converts info/tip blocks to raw HTML callouts and updates links to <a>.
packages/docs/site/i18n/bn/docusaurus-plugin-content-docs/current/main/guides/playground-for-everyone.md Converts (commented and active) tips/info blocks to raw HTML callouts with explicit titles.
packages/docs/site/i18n/bn/docusaurus-plugin-content-docs/current/main/contributing/code.md Converts (commented and active) callouts to raw HTML with explicit titles and updates links.
packages/docs/site/i18n/bn/docusaurus-plugin-content-docs/current/main/about/launch.md Converts (commented and active) links inside callouts to <a>.
packages/docs/site/i18n/bn/docusaurus-plugin-content-docs/current/main/about/index.md Normalizes list formatting and converts tips to raw HTML callouts.
packages/docs/site/i18n/bn/docusaurus-plugin-content-docs/current/main/about/build.md Converts (commented and active) info blocks to raw HTML callouts.
packages/docs/site/i18n/bn/docusaurus-plugin-content-docs/current/blueprints/tutorial/index.md Converts tips (including commented English) to raw HTML callouts.
packages/docs/site/i18n/bn/docusaurus-plugin-content-docs/current/blueprints/tutorial/03-build-your-first-blueprint.md Converts tip/note blocks to raw HTML callouts, updates links, and normalizes list indentation.
packages/docs/site/i18n/bn/docusaurus-plugin-content-docs/current/blueprints/tutorial/01-what-are-blueprints-what-you-can-do-with-them.md Converts resource list links to <a>.
packages/docs/site/i18n/bn/docusaurus-plugin-content-docs/current/blueprints/05-steps.md Converts step-library tip to raw HTML callout and updates links to <a>.
packages/docs/site/i18n/bn/docusaurus-plugin-content-docs/current/blueprints/02-using-blueprints.md Converts tips to raw HTML callouts and updates linked code references to <a><code>.
packages/docs/site/docs/main/web-instance.md Converts caution admonition to raw HTML callout and updates internal link to <a>.
packages/docs/site/docs/main/resources.md Converts tip admonition to raw HTML callout.
packages/docs/site/docs/main/intro.md Converts tip admonition to raw HTML callout and updates key link to <a>.
packages/docs/site/docs/main/guides/providing-content-for-your-demo.md Converts tip admonition to raw HTML callout and updates links to <a>.
packages/docs/site/docs/main/guides/playground-for-everyone.md Converts tip admonition to raw HTML callout with explicit title.
packages/docs/site/docs/main/guides/phpunit-testing.md Converts info admonition to raw HTML callout.
packages/docs/site/docs/main/guides/github-action-pr-preview.md Converts warning/danger blocks to raw HTML callouts and updates some links to <a>.
packages/docs/site/docs/main/contributing/translations.md Converts links inside callouts to HTML anchors.
packages/docs/site/docs/main/contributing/contributor-day.md Converts link inside callout to <a>.
packages/docs/site/docs/main/contributing/code.md Converts tip admonition to raw HTML callout with explicit title.
packages/docs/site/docs/main/about/launch.md Converts link inside callout to <a>.
packages/docs/site/docs/main/about/index.md Normalizes list formatting and converts tip admonition to raw HTML callout.
packages/docs/site/docs/developers/24-limitations/01-index.md Converts tip admonition to raw HTML callout.
packages/docs/site/docs/developers/23-architecture/18-host-your-own-playground.md Converts source-file link in callout to <a>.
packages/docs/site/docs/developers/23-architecture/10-browser-iframe-rendering.md Converts callout links to HTML anchors.
packages/docs/site/docs/developers/06-apis/query-api/01-index.md Converts CORS reference link inside callout to <a>.
packages/docs/site/docs/developers/06-apis/javascript-api/01-index.md Converts internal link inside callout to <a>.
packages/docs/site/docs/developers/06-apis/01-index.md Converts links inside callouts to <a> and converts caution admonition to raw HTML callout.
packages/docs/site/docs/developers/05-local-development/04-wp-playground-cli.md Converts caution admonition to raw HTML callout.
packages/docs/site/docs/developers/05-local-development/02-vscode-extension.md Converts documentation links in callout to <a>.
packages/docs/site/docs/developers/05-local-development/01-wp-now.md Converts caution admonition to raw HTML callout and updates doc links to <a>.
packages/docs/site/docs/developers/03-build-an-app/01-index.md Converts caution/tip admonitions to raw HTML callouts and updates links to <a>.
packages/docs/site/docs/blueprints/tutorial/index.md Converts tip admonition to raw HTML callout and updates internal link to <a>.
packages/docs/site/docs/blueprints/tutorial/03-build-your-first-blueprint.md Converts tip/note admonitions to raw HTML callouts and updates links to <a>.
packages/docs/site/docs/blueprints/tutorial/01-what-are-blueprints-what-you-can-do-with-them.md Converts resource list links to <a> anchors.
packages/docs/site/docs/blueprints/intro.md Converts tip admonition to raw HTML callout and normalizes list indentation.
packages/docs/site/docs/blueprints/09-troubleshoot-and-debug-blueprints.md Converts multiple admonitions to raw HTML callouts and updates links to HTML anchors.
packages/docs/site/docs/blueprints/08-examples.md Converts tip/note admonitions to raw HTML callouts and updates links.
packages/docs/site/docs/blueprints/07-json-api-and-function-api.md Converts note to raw HTML callout and updates links to <a>.
packages/docs/site/docs/blueprints/05-steps.md Normalizes list indentation and converts tip admonition to raw HTML callout.
packages/docs/site/docs/blueprints/04-resources.md Converts callout links to <a><code> equivalents for HTML compatibility.
packages/docs/site/docs/blueprints/02-using-blueprints.md Converts tips to raw HTML callouts and updates linked code references to <a><code>.
Comments suppressed due to low confidence (2)

packages/docs/site/i18n/bn/docusaurus-plugin-content-docs/current/main/web-instance.md:1

  • This line is inside a raw HTML callout (<div class=\"callout ...\">), but it still uses Markdown link syntax ([text](url)). Markdown links are not parsed inside HTML blocks in MDX/CommonMark, so the link will render as literal brackets/parentheses. Convert it to an HTML anchor (e.g. <a href=\"/developers/architecture/host-your-own-playground\">…</a>) to match the approach used elsewhere in this PR.
    packages/docs/site/src/css/custom.css:1
  • The new 'fallback' for .callout-tip relies on var(--wp--preset--color--acid-green-3) without providing a fallback value. If that preset variable is not defined in the Docusaurus build context, this resolves to an invalid value and the background won't be set (negating the intended fallback). Consider adding a second argument fallback to var(...) (or referencing an existing Docusaurus/theme color variable) so callout-tip has a deterministic background in all environments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +21 to 23
**This is a regular GitHub Action, not a reusable workflow**

Reference it as a step inside `jobs.<job_id>.steps:` (i.e. `jobs.<job_id>.steps[*].uses:`) — never as `jobs.<job_id>.uses:` at the job level. The job-level form is valid YAML for reusable workflows, so it is a common mistake (including by AI coding assistants), but it will not work with this action.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

[Type] Documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants