Skip to content

Add guide for testing Gutenberg tickets with Playground#156

Merged
huzaifaalmesbah merged 8 commits intoWordPress:trunkfrom
khushdoms:add-playground-testing-guide
May 5, 2026
Merged

Add guide for testing Gutenberg tickets with Playground#156
huzaifaalmesbah merged 8 commits intoWordPress:trunkfrom
khushdoms:add-playground-testing-guide

Conversation

@khushdoms
Copy link
Copy Markdown
Contributor

This PR adds a step-by-step guide for testing Gutenberg tickets using WordPress Playground.
It aims to help new contributors quickly test issues without needing a full local setup.
Feedback welcome.

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 17, 2026

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Co-authored-by: khushdoms <khushdoms@git.wordpress.org>
Co-authored-by: huzaifaalmesbah <huzaifaalmesbah@git.wordpress.org>
Co-authored-by: ozgursar <ozgursar@git.wordpress.org>
Co-authored-by: 3kori <r1k0@git.wordpress.org>
Co-authored-by: ankitguptaindia <ankit-k-gupta@git.wordpress.org>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

Copy link
Copy Markdown
Member

@huzaifaalmesbah huzaifaalmesbah left a comment

Choose a reason for hiding this comment

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

I think we need a more structured and purpose-driven guide specifically for testing Gutenberg using Playground.

Right now, the PR mainly outlines the basic steps for installing the Gutenberg plugin in Playground, which is helpful, but it doesn’t fully address the actual testing workflow.

Instead, the content should be aligned more closely with how core tickets are tested using Playground, similar to the approach described here:
https://make.wordpress.org/test/handbook/get-setup-for-testing/test-core-tickets-with-playground/

In particular, the guide should:

  • Focus on the testing process rather than just setup
  • Explain how to reproduce issues or test specific pr Gutenberg changes
  • Provide clear, step-by-step instructions tailored to real testing scenarios

Updating the content in this direction would make it more useful and consistent with existing testing documentation.

@khushdoms
Copy link
Copy Markdown
Contributor Author

Thanks for the detailed feedback!

That makes sense — I’ll update the guide to focus more on the actual testing workflow, including reproducing issues and testing PRs, aligned with the core testing approach.

I’ll push an updated version shortly.

Comment thread test-gutenberg-with-playground.md Outdated
Comment thread test-gutenberg-with-playground.md Outdated
Comment thread get-setup-for-testing/test-gutenberg-with-playground.md
@khushdoms
Copy link
Copy Markdown
Contributor Author

Thanks for the helpful feedback @ozgursar !
I’ll update the guide to include a clear example of applying a Gutenberg PR using the Playground query parameter and adjust the content accordingly.

Copy link
Copy Markdown
Contributor Author

@khushdoms khushdoms left a comment

Choose a reason for hiding this comment

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

Add guide for testing Gutenberg tickets with Playground

Comment thread test-gutenberg-with-playground.md Outdated
Copy link
Copy Markdown
Member

@huzaifaalmesbah huzaifaalmesbah left a comment

Choose a reason for hiding this comment

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

Looks good to me. I’ve suggested 2 changes. once those are addressed, we can merge this PR.

@@ -0,0 +1,146 @@
# Testing Gutenberg Tickets with WordPress Playground
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Hey, I noticed this test-gutenberg-with-playground.md file is currently under the root directory. Could you please move it to the get-setup-for-testing directory?

Comment thread get-setup-for-testing/test-gutenberg-with-playground.md
khushdoms and others added 3 commits May 5, 2026 18:36
@khushdoms
Copy link
Copy Markdown
Contributor Author

Thanks for the review!

Moved the file to the correct get-setup-for-testing directory
Added the “Finding tickets to test” section as suggested

Please let me know if anything else is needed.

@khushdoms khushdoms requested a review from huzaifaalmesbah May 5, 2026 13:21
Copy link
Copy Markdown
Member

@huzaifaalmesbah huzaifaalmesbah left a comment

Choose a reason for hiding this comment

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

Looks good

@huzaifaalmesbah huzaifaalmesbah merged commit ea3f8be into WordPress:trunk May 5, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Gutenberg ticket testing with Playground - "Test Gutenberg Tickets with Playground"

4 participants