Skip to content

[docs] Update docs screenshots for the new Dock UI and refresh translations - #4242

Open
fellyph wants to merge 14 commits into
trunkfrom
updating-new-ui-screenshots
Open

[docs] Update docs screenshots for the new Dock UI and refresh translations#4242
fellyph wants to merge 14 commits into
trunkfrom
updating-new-ui-screenshots

Conversation

@fellyph

@fellyph fellyph commented Aug 3, 2026

Copy link
Copy Markdown
Collaborator

Brings the documentation screenshots in line with the current Playground UI and updates the translated pages that reference them.

Changes

Screenshots — regenerated 13 Dock screenshots (static/img/dock/*) and removed 5 images showing UI that no longer exists (playground-manager-*, storage-type-device, log-errors, demo). Kept the five annotated captures that already show the new UI (export-playground, saving-playground, refresh-playground-button, open-blueprints-gallery, unsaved-playground-warning) and used them in place of the plain Dock panes, since the arrows point at the control each step describes.

English docsquick-start-guide.md, web-instance.md, and guides/playground-for-everyone.md updated for the new images, with alt text describing what each annotation highlights.

Translations — bn, es, fr, gu, ja, pt-BR, tl updated to match, each keeping the English original commented out above the translated block, per the existing convention. Every image link in the changed files now uses the raw githubusercontent.com URL so it survives the WordPress.org handbook import.

New: Italian translations for the three updated pages.

Notes

  • The it locale is not registered in docusaurus.config.js (neither are the 16 pre-existing Italian files), so those pages aren't built yet. Enabling it is a separate change.
  • dock/dock-export-playground.webp and dock/store-permanently-browser.webp are now unreferenced — left in place for now.
  • ja/blueprints/09-troubleshoot-and-debug-blueprints.md is well behind the English page (99 untranslated blocks); out of scope here.

Testing

npm run build:docs passes; broken-anchor warning count is unchanged from trunk (276). prettier --check clean.

Copilot AI review requested due to automatic review settings August 3, 2026 20:44
@github-actions github-actions Bot added the [Type] Documentation Improvements or additions to documentation label Aug 3, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

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.

Updates documentation screenshots and localized docs to match the current Playground Dock UI, and adds new Italian translations for key pages.

Changes:

  • Replaces/updates image references to new Dock UI screenshots (using raw.githubusercontent.com URLs for WP.org import compatibility).
  • Refreshes several translated pages (tl, pt-BR, es, fr, bn, gu, ja) to match updated English content and screenshots.
  • Adds new Italian translations for quick-start-guide, web-instance, and playground-for-everyone.

Reviewed changes

Copilot reviewed 42 out of 55 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
packages/docs/site/i18n/tl/docusaurus-plugin-content-docs/current/main/quick-start-guide.md Updates Tagalog quick start content + Dock screenshots and new persistence/export steps
packages/docs/site/i18n/tl/docusaurus-plugin-content-docs/current/main/about/build.md Updates Tagalog “Build” page with Dock-based local-directory persistence instructions
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/quick-start-guide.md Updates pt-BR quick start to new Dock UI and persistence/export sections
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/playground-for-everyone.md Updates pt-BR guide with new Dock-based instructions and refreshed screenshots/alt text
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/about/build.md Updates pt-BR “Build” page to new local-directory storage workflow + Dock screenshots
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md Rewrites pt-BR “limitations” persistence/recovery section and adds Dock imagery
packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/blueprints/09-troubleshoot-and-debug-blueprints.md Updates pt-BR Blueprints troubleshooting to reference Dock Files/Database/Logs + new screenshots
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/main/about/build.md Updates JA “Build” page local-directory storage instructions and Dock screenshots
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md Updates JA persistence/recovery documentation and Dock imagery
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/blueprints/tutorial/03-build-your-first-blueprint.md Adds/aligns commented English source blocks and improves screenshot alt text in JA tutorial
packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/blueprints/09-troubleshoot-and-debug-blueprints.md Updates JA troubleshooting to Dock-based inspection and refreshed screenshots/wording
packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/web-instance.md Adds new Italian translation for the web instance (Dock, persistence, tools, export)
packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/quick-start-guide.md Adds new Italian translation for the quick start guide with Dock workflow
packages/docs/site/i18n/it/docusaurus-plugin-content-docs/current/main/guides/playground-for-everyone.md Adds new Italian translation for the “Playground for everyone” guide + Dock screenshots
packages/docs/site/i18n/gu/docusaurus-plugin-content-docs/current/main/about/build.md Updates Gujarati “Build” page for local-directory storage workflow + Dock screenshot
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/main/quick-start-guide.md Updates FR quick start with Dock persistence/export/restore flow + new screenshots
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/main/guides/playground-for-everyone.md Updates FR guide to Dock UI flow + refreshed screenshots/alt text
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md Updates FR limitations persistence/recovery wording and Dock imagery
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/blueprints/tutorial/03-build-your-first-blueprint.md Improves FR tutorial comment structure and screenshot alt text
packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/blueprints/09-troubleshoot-and-debug-blueprints.md Updates FR troubleshooting to Dock Files/Database/Logs and new screenshots
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/main/quick-start-guide.md Updates ES quick start with Dock persistence/export/restore flow + new screenshots
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/main/guides/playground-for-everyone.md Updates ES guide to Dock UI flow + refreshed screenshots/alt text
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/main/about/build.md Updates ES “Build” page with local-directory storage workflow + Dock screenshot
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md Updates ES limitations persistence/recovery wording and Dock imagery
packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/blueprints/09-troubleshoot-and-debug-blueprints.md Updates ES troubleshooting Doc to Dock Files/Database/Logs + new screenshots
packages/docs/site/i18n/bn/docusaurus-plugin-content-docs/current/main/guides/playground-for-everyone.md Updates BN guide to Dock UI flow + refreshed screenshots/alt text
packages/docs/site/i18n/bn/docusaurus-plugin-content-docs/current/main/about/build.md Updates BN “Build” page with local-directory storage workflow + Dock screenshot
packages/docs/site/docs/main/web-instance.md Switches English doc images to raw GitHub URLs + updates to annotated Dock screenshots
packages/docs/site/docs/main/quick-start-guide.md Switches English doc images to raw GitHub URLs + updates to annotated Dock screenshots
packages/docs/site/docs/main/guides/playground-for-everyone.md Updates English guide images and persistence section screenshots (raw GitHub URLs)

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

Comment on lines +90 to 92
<!-- ![Playground performance graph](https://raw.githubusercontent.com/WordPress/wordpress-playground/refs/heads/trunk/packages/docs/site/static/img/playground-performance-graph.webp) -->

![Save Button](https://raw.githubusercontent.com/WordPress/wordpress-playground/refs/heads/trunk/packages/docs/site/static/img/playground-performance-graph.webp)
Comment on lines +23 to 26
You can seamlessly integrate Playground into your development workflow to launch a local WordPress environment quickly for testing your code. You can do this directly [from the terminal](/developers/local-development/wp-playground-cli) or [your preferred IDE.](/developers/local-development/vscode-extension)
-->

Maaari mong i-integrate nang seamless ang Playground sa iyong development workflow upang mabilis na ilunsad ang lokal na WordPress environment para sa pag-test ng iyong code. Magagawa mo ito nang direkta [mula sa terminal](/developers/local-development/wp-now) o sa [paborito mong IDE](/developers/local-development/vscode-extension).

Questa pagina ti guiderà attraverso ognuna di esse. Se preferisci imparare in modo visivo, ecco un video. Alcuni dettagli dell'interfaccia mostrati nel video sono precedenti al Dock: segui i passaggi scritti qui sotto per l'interfaccia attuale.

<iframe width="752" height="423.2" title="Getting started with WordPress Playground" src="https://video.wordpress.com/v/3UBIXJ9S?autoPlay=false&amp;height=1080&amp;width=1920&amp;fill=true" class="editor-media-modal-detail__preview is-video" allowFullScreen></iframe>
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