Skip to content

[Docs] Updating limitations page about CLI updates#3464

Open
fellyph wants to merge 12 commits intotrunkfrom
updating-limitations-cli
Open

[Docs] Updating limitations page about CLI updates#3464
fellyph wants to merge 12 commits intotrunkfrom
updating-limitations-cli

Conversation

@fellyph
Copy link
Copy Markdown
Collaborator

@fellyph fellyph commented Apr 3, 2026

This pull request updates the documentation on WordPress Playground limitations, improving both the English and Spanish versions. The changes clarify technical details, update performance expectations, and add a new section highlighting recent improvements. The Spanish translation is also significantly enhanced for accuracy, clarity, and consistency with the English source.

Documentation improvements:

  • Added a "Recent improvements" section to both English and Spanish docs, outlining resolved limitations such as large file downloads, PHP curl uploads, long-running PHP responses, and improved error handling for failed downloads. [1] [2]
  • Updated performance expectations: clarified WASM file sizes (now 5–15MB per PHP version), initial memory allocation, and browser/device-specific performance notes. [1] [2]
  • Improved explanations for iframe quirks, WP-CLI support, and how to persist work in Playground, with clearer instructions and more accurate technical details. [1] [2]

Spanish translation enhancements:

  • Significantly revised the Spanish translation for accuracy, clarity, and consistency, including improvements to terminology, formatting, and explanatory comments.
  • Updated Spanish content to match new English sections, including the "Recent improvements" section and revised guidance on performance, browser support, and development tips. [1] [2]

fellyph added 4 commits April 3, 2026 12:03
…t improvements

- Clarified factors affecting performance, including updated WASM file sizes and memory allocation details.
- Added a new section on recent improvements addressing large file downloads, PHP curl file uploads, long-running PHP responses, and enhanced error handling for download failures.
- Minor text corrections for consistency in language usage.
- Improved clarity and consistency in the Spanish text regarding browser-specific behaviors, temporary storage, iframe quirks, and WP-CLI support.
- Minor text adjustments for better readability and accuracy in translations.
- Enhanced clarity and consistency in the French text regarding browser-specific behaviors, intentional temporary storage, iframe quirks, and WP-CLI support.
- Minor adjustments made for improved readability and accuracy in translations.
- Enhanced clarity and consistency in the Portuguese text regarding browser-specific behaviors, intentional temporary storage, iframe quirks, and WP-CLI support.
- Minor adjustments made for improved readability and accuracy in translations.
@fellyph fellyph requested review from a team, brandonpayton, Copilot and mho22 April 3, 2026 11:26
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

Updates the “Limitations” documentation to reflect recent Playground improvements, clarify performance expectations, and refine localized translations.

Changes:

  • Expanded “Recent improvements” section describing resolved limitations (streaming downloads, cURL uploads, long-running responses, error handling).
  • Updated performance expectations (WASM size, initial memory allocation) and refined wording for iframe quirks and WP-CLI usage.
  • Refreshed localized docs (ES/FR/PT-BR) for clarity and closer alignment with the English source.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 7 comments.

File Description
packages/docs/site/docs/developers/24-limitations/01-index.md Updates English limitations content (performance details, WP-CLI note, adds “Recent improvements”).
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md Updates Spanish translation and adds “Recent improvements”; aligns with updated English content.
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md Updates French translation and adds “Recent improvements”; aligns with updated English content.
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md Updates pt-BR translation and adds “Recent improvements”; aligns with updated English content.

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

fellyph and others added 2 commits April 3, 2026 14:17
…ent/developers/24-limitations/01-index.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…ent/developers/24-limitations/01-index.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
fellyph and others added 6 commits April 3, 2026 14:34
…ent/developers/24-limitations/01-index.md

Co-authored-by: Yannick Decat <17177411+mho22@users.noreply.github.com>
…ent/developers/24-limitations/01-index.md

Co-authored-by: Yannick Decat <17177411+mho22@users.noreply.github.com>
…ent/developers/24-limitations/01-index.md

Co-authored-by: Yannick Decat <17177411+mho22@users.noreply.github.com>
…ent/developers/24-limitations/01-index.md

Co-authored-by: Yannick Decat <17177411+mho22@users.noreply.github.com>
…ent/developers/24-limitations/01-index.md

Co-authored-by: Yannick Decat <17177411+mho22@users.noreply.github.com>
Copy link
Copy Markdown
Collaborator

@mho22 mho22 left a comment

Choose a reason for hiding this comment

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

I will probably need to review the FR version after the EN version has been updated.

- **Plugin size**: Large plugins take longer to install at runtime
- **Network speed**: WASM files are 15-30MB
- **Device memory**: Low-memory devices may experience slowdowns
- **Network speed**: WASM files are approximately 5-15MB per PHP version (reduced significantly by the MAIN_MODULE=2 build optimization)
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Unfortunately this is not correct. WASM files are still between 15-30MB. But it was worse before MAIN_MODULE=2 [ 5MB heavier in some cases so it sometimes exceeded 30MB ] and this is probably due to some static libraries that should become dynamic ones, like Imagick, GD or Soap.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants