Skip to content

[Docs] Adding playground for everyone guide - #3103

Merged
fellyph merged 11 commits into
trunkfrom
adding-playground-for-everyone-guide
Feb 4, 2026
Merged

fellyph merged 11 commits into
trunkfrom
adding-playground-for-everyone-guide

Conversation

@fellyph

@fellyph fellyph commented Jan 9, 2026

Copy link
Copy Markdown
Collaborator

This pull request adds a new beginner-friendly guide to the documentation, highlighting how WordPress Playground can be used by non-developers, and updates the guides index and sidebar to include this resource.

Documentation content additions:

  • Added a new guide, playground-for-everyone.md, explaining how WordPress Playground can be used by beginners, site owners, and everyday users, including practical tips, screenshots, and instructions for saving and exporting Playground instances.

Documentation navigation updates:

  • Updated the guides index (index.md) to feature the new "WordPress Playground for Everyone" guide, making it more visible to users browsing available guides.
  • Added the new guide to the documentation sidebar configuration (sidebars.js), ensuring it appears in the navigation menu.

@fellyph
fellyph requested a review from akirk January 9, 2026 16:00
@fellyph
fellyph requested a review from bgrgicak January 15, 2026 08:06
Comment thread packages/docs/site/docs/main/guides/playground-for-everyone.md Outdated
Comment thread packages/docs/site/docs/main/guides/playground-for-everyone.md Outdated
Comment thread packages/docs/site/docs/main/guides/playground-for-everyone.md Outdated
Comment thread packages/docs/site/docs/main/guides/playground-for-everyone.md
fellyph and others added 5 commits January 16, 2026 18:48
Co-authored-by: Bero <berislav.grgicak@gmail.com>
Co-authored-by: Bero <berislav.grgicak@gmail.com>
…round for Everyone guide

## What?
Introduced translations for the "Playground for Everyone" guide in Spanish, French, and Portuguese.

## Why?
To enhance accessibility and provide non-English speaking users with comprehensive resources to experiment with WordPress Playground.

## How?
- Created new markdown files for each language, maintaining the original structure and content.
- Preserved English text in HTML comments for reference.
- Ensured all technical terms and links remain unchanged.
@fellyph

fellyph commented Feb 2, 2026

Copy link
Copy Markdown
Collaborator Author

@bgrgicak can you take a look again?

@fellyph
fellyph requested a review from bgrgicak February 2, 2026 18:49

@bgrgicak bgrgicak left a comment

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.

Looks good! Thanks for adjusting the WordPress Playground for Everyone section.

@fellyph
fellyph merged commit 9e9c6c9 into trunk Feb 4, 2026
35 checks passed
@fellyph
fellyph deleted the adding-playground-for-everyone-guide branch February 4, 2026 09:48
@rollybueno rollybueno mentioned this pull request Sep 21, 2026
fellyph pushed a commit that referenced this pull request Sep 22, 2026
### Motivation for the change, related issues
English docs/main/guides/index.md now lists 13 guides, including PHP
snippets
([#3644](#3644)),
PHP frameworks
([#3766](#3766)),
Playground for Everyone
([#3103](#3103)),
Blueprint content import
([#4032](#4032)),
PR preview buttons
([#2893](#2893)),
the agent skill
([#3282](#3282)),
runCLI
([#2833](#2833)),
PHPUnit
([#3487](#3487)),
and Playwright E2E
([#3360](#3360)).

The Tagalog index still had only the iOS, demo content, theme, and
plugin guides. /tl/guides readers would miss the newer entries, even
though Docusaurus can fall back to English for pages that are not
translated yet.

### Implementation details

1. Updated
packages/docs/site/i18n/tl/docusaurus-plugin-content-docs/current/main/guides/index.md.
2. Expanded the frontmatter description to match English.
3. Kept and aligned the four existing Tagalog entries (iOS / Blocknotes,
demo content, theme developers, plugin developers).
4. Added Tagalog blurbs for the nine missing guides, in the same order
as English.
5. Kept the original English above each block in HTML comments, per the
translation guide.
6. Testing Instructions (or ideally a Blueprint)
7. Docs-only change; no Blueprint.

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

- **Documentation**
  - Expanded the Tagalog guides index from 4 to 13 guide links.
- Added translated guides covering PHP snippets and embeds, PHP
frameworks, WordPress Playground, Blueprints, GitHub Actions, the
Playground Agent Skill, CLI usage, PHPUnit, and Playwright testing.
- Revised the page description, introduction, and existing guide
sections for clearer Tagalog-language guidance.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->
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.

2 participants