[Docs] Updating limitations page about CLI updates#3464
[Docs] Updating limitations page about CLI updates#3464
Conversation
…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.
There was a problem hiding this comment.
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.
...site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md
Show resolved
Hide resolved
...cs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md
Show resolved
Hide resolved
...cs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md
Show resolved
Hide resolved
...site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md
Show resolved
Hide resolved
...cs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md
Outdated
Show resolved
Hide resolved
...cs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md
Outdated
Show resolved
Hide resolved
...cs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md
Outdated
Show resolved
Hide resolved
…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>
...cs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md
Outdated
Show resolved
Hide resolved
...cs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md
Outdated
Show resolved
Hide resolved
...cs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md
Outdated
Show resolved
Hide resolved
...cs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md
Outdated
Show resolved
Hide resolved
...cs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md
Outdated
Show resolved
Hide resolved
…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>
mho22
left a comment
There was a problem hiding this comment.
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) |
There was a problem hiding this comment.
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.
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:
Spanish translation enhancements: