Open
Conversation
- Added details on the flexibility of `blueprint.json` location within ZIP files, allowing it to be at the root level or one directory deep. - Included examples of both valid ZIP structures and clarified error handling for ambiguous cases with multiple `blueprint.json` files. - Updated troubleshooting section to reflect the new structure options for `blueprint.json`.
- Enhanced the clarity and consistency of the description and title for Blueprint bundles. - Improved the structure and formatting of the documentation, including the addition of new sections on usage in the website and CLI. - Provided clearer examples for using Blueprint bundles, including local and remote options.
- Introduced a new document detailing Blueprint bundles, including their structure, usage, and examples for both website and CLI integration. - Enhanced accessibility for Spanish-speaking users by providing comprehensive explanations and code snippets related to Blueprint packages. - Included guidelines for creating and utilizing Blueprint bundles effectively within the WordPress Playground environment.
- Introduced a new document detailing Blueprint bundles in French, including their structure, usage, and examples for both website and CLI integration. - Enhanced accessibility for French-speaking users by providing comprehensive explanations and code snippets related to Blueprint packages. - Included guidelines for creating and utilizing Blueprint bundles effectively within the WordPress Playground environment.
Contributor
There was a problem hiding this comment.
Pull request overview
Expands the “Blueprint bundles” documentation across locales, adding clearer definitions, usage instructions (website + CLI), ZIP bundle creation steps, and new guidance about flexible ZIP layouts (including macOS __MACOSX behavior) plus troubleshooting updates.
Changes:
- Adds/expands bundle overview and “how to use” sections across locales.
- Documents flexible ZIP layouts (root or one-directory-deep) and ambiguity behavior.
- Updates troubleshooting guidance to reflect the new ZIP-detection rules.
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 8 comments.
| File | Description |
|---|---|
| packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md | Major PT-BR expansion + adds ZIP-structure flexibility + updated troubleshooting. |
| packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md | New French page with full bundle usage + ZIP-structure flexibility + troubleshooting. |
| packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md | New Spanish page with full bundle usage + ZIP-structure flexibility + troubleshooting. |
| packages/docs/site/docs/blueprints/06-bundles.md | Adds ZIP-structure flexibility section and updates troubleshooting wording in English. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md
Show resolved
Hide resolved
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md
Outdated
Show resolved
Hide resolved
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md
Show resolved
Hide resolved
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md
Show resolved
Hide resolved
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md
Show resolved
Hide resolved
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md
Outdated
Show resolved
Hide resolved
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md
Outdated
Show resolved
Hide resolved
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md
Show resolved
Hide resolved
…ent/blueprints/06-bundles.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
mho22
reviewed
Apr 6, 2026
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md
Outdated
Show resolved
Hide resolved
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md
Outdated
Show resolved
Hide resolved
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md
Outdated
Show resolved
Hide resolved
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md
Outdated
Show resolved
Hide resolved
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md
Outdated
Show resolved
Hide resolved
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md
Outdated
Show resolved
Hide resolved
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md
Outdated
Show resolved
Hide resolved
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md
Outdated
Show resolved
Hide resolved
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md
Outdated
Show resolved
Hide resolved
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/blueprints/06-bundles.md
Outdated
Show resolved
Hide resolved
…ent/blueprints/06-bundles.md Co-authored-by: Yannick Decat <17177411+mho22@users.noreply.github.com>
…ent/blueprints/06-bundles.md Co-authored-by: Yannick Decat <17177411+mho22@users.noreply.github.com>
…ent/blueprints/06-bundles.md Co-authored-by: Yannick Decat <17177411+mho22@users.noreply.github.com>
…ent/blueprints/06-bundles.md Co-authored-by: Yannick Decat <17177411+mho22@users.noreply.github.com>
…ent/blueprints/06-bundles.md Co-authored-by: Yannick Decat <17177411+mho22@users.noreply.github.com>
…ent/blueprints/06-bundles.md Co-authored-by: Yannick Decat <17177411+mho22@users.noreply.github.com>
…ent/blueprints/06-bundles.md Co-authored-by: Yannick Decat <17177411+mho22@users.noreply.github.com>
…ent/blueprints/06-bundles.md Co-authored-by: Yannick Decat <17177411+mho22@users.noreply.github.com>
…ent/blueprints/06-bundles.md Co-authored-by: Yannick Decat <17177411+mho22@users.noreply.github.com>
…ent/blueprints/06-bundles.md Co-authored-by: Yannick Decat <17177411+mho22@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This pull request updates and significantly expands the documentation for Blueprint bundles in both English and Brazilian Portuguese. The changes clarify bundle formats, add step-by-step usage instructions, and introduce new sections on ZIP structure flexibility, troubleshooting, and translation improvements.
Key documentation improvements:
Expanded and clarified documentation (English, French, Spanish, and Portuguese):
blueprint.jsoncan be located either at the root or one directory deep, and that macOS's__MACOSXdirectory is ignored. Provided illustrative examples of valid ZIP layouts and clarified error behavior for ambiguous bundles. [1] [2]