From c8f6d4a115c9f1eeabf64b9caeb9832f4deb98ac Mon Sep 17 00:00:00 2001 From: Md Aminul Islam <56115259+theaminuli@users.noreply.github.com> Date: Fri, 31 Oct 2025 17:31:10 +0600 Subject: [PATCH 01/11] Add contributing guidelines to CONTRIBUTING.md Added contributing guidelines for the WordPress Playground project, detailing how to contribute, guidelines to follow, and links to relevant resources. --- CONTRIBUTING.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000000..9dac0f1d4c --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,47 @@ +# Contributing Guidelines + +Welcome to the **WordPress Playground** project! 🎉 +Playground brings WordPress to the browser through WebAssembly — a place where anyone can experiment, test, and build with WordPress instantly. +We’re excited to have you here, and everyone is welcome to contribute. + +--- + +## 💡 How Can I Contribute? + +WordPress Playground is an open-source project and welcomes all contributors from code to design, and from documentation to triage. If the feature you need is missing, you are more than welcome to start a discussion, open an issue, and even propose a Pull Request to implement it. + +Here's a few quickstart guides to get you started: + +- Code contributions – see the [developer section](https://wordpress.github.io/wordpress-playground/docs/contributing/code). +- Documentation – see the [documentation section](https://wordpress.github.io/wordpress-playground/docs/contributing/documentation). +- Triage – see the [triage section](https://wordpress.github.io/wordpress-playground/contributing/#triaging-issues). +- Contributions to translations – see the [translations section](https://wordpress.github.io/wordpress-playground/contributing/translations). +- Reporting bugs – open an [issue](https://github.com/WordPress/wordpress-playground/issues/new) in the repository. +- Ideas, designs or anything else – open a [GitHub discussion](https://github.com/WordPress/wordpress-playground/discussions) and let's talk! + +--- + +## 🧭 Guidelines + +- As with all WordPress projects, we’re committed to a **welcoming, inclusive, and respectful environment** for everyone. + Please follow our [Code of Conduct](https://make.wordpress.org/handbook/community-code-of-conduct/). + +- Before submitting a pull request, review the + [repository management and pull request best practices](https://github.com/WordPress/gutenberg/blob/trunk/docs/contributors/repository-management.md#pull-requests), + and follow the WordPress + [JavaScript coding standards](https://developer.wordpress.org/coding-standards/wordpress-coding-standards/javascript/) + and [accessibility guidelines](https://developer.wordpress.org/coding-standards/wordpress-coding-standards/accessibility/). + +- **Accessibility first:** Always test your work following the + [accessibility testing instructions](https://github.com/WordPress/gutenberg/blob/HEAD/docs/contributors/accessibility-testing.md). + +- **Maintain compatibility:** + If your changes affect shared functions, modules, or APIs, ensure they don’t break existing Playground environments or integrations. + +- You maintain copyright over your contributions. + By submitting a pull request, you agree to release your code under [Playground’s License](/LICENSE.md). + +--- + +Thank you for contributing to WordPress Playground! 💙 +Together, we’re shaping the future of web publishing. From 36607e5b0c794bafde3a20e192751ee4a36c9e7d Mon Sep 17 00:00:00 2001 From: Md Aminul Islam <56115259+theaminuli@users.noreply.github.com> Date: Fri, 31 Oct 2025 17:37:21 +0600 Subject: [PATCH 02/11] Remove duplicate thank you message in CONTRIBUTING.md --- CONTRIBUTING.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 9dac0f1d4c..544b5aa522 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -43,5 +43,4 @@ Here's a few quickstart guides to get you started: --- -Thank you for contributing to WordPress Playground! 💙 -Together, we’re shaping the future of web publishing. +Thank you for contributing to WordPress Playground! 💙 From 0a9f959c05fa296e17fec8805e3ab6d44c9b1faa Mon Sep 17 00:00:00 2001 From: Md Aminul Islam <56115259+theaminuli@users.noreply.github.com> Date: Fri, 31 Oct 2025 17:48:59 +0600 Subject: [PATCH 03/11] Revise contributing guidelines and links Updated links and standards for pull requests and coding guidelines. --- CONTRIBUTING.md | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 544b5aa522..2544b572ab 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -27,13 +27,11 @@ Here's a few quickstart guides to get you started: Please follow our [Code of Conduct](https://make.wordpress.org/handbook/community-code-of-conduct/). - Before submitting a pull request, review the - [repository management and pull request best practices](https://github.com/WordPress/gutenberg/blob/trunk/docs/contributors/repository-management.md#pull-requests), - and follow the WordPress - [JavaScript coding standards](https://developer.wordpress.org/coding-standards/wordpress-coding-standards/javascript/) - and [accessibility guidelines](https://developer.wordpress.org/coding-standards/wordpress-coding-standards/accessibility/). - -- **Accessibility first:** Always test your work following the - [accessibility testing instructions](https://github.com/WordPress/gutenberg/blob/HEAD/docs/contributors/accessibility-testing.md). + [repository management and pull request best practices](https://wordpress.github.io/wordpress-playground/contributing/code), + and follow the WordPress Playground coding and accessibility standards. + +- WordPress Coding Standards [Coding Standards](https://developer.wordpress.org/coding-standards/wordpress-coding-standards/) +- Before submitting a pull request, review the - **Maintain compatibility:** If your changes affect shared functions, modules, or APIs, ensure they don’t break existing Playground environments or integrations. From f7738fd78af36feead10645676d038f9a314265c Mon Sep 17 00:00:00 2001 From: Md Aminul Islam <56115259+theaminuli@users.noreply.github.com> Date: Fri, 31 Oct 2025 17:51:23 +0600 Subject: [PATCH 04/11] Refactor contributing guidelines for clarity Removed redundant line breaks and merged sentences for clarity. --- CONTRIBUTING.md | 22 +++++----------------- 1 file changed, 5 insertions(+), 17 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 2544b572ab..75e376e116 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,8 +1,7 @@ # Contributing Guidelines Welcome to the **WordPress Playground** project! 🎉 -Playground brings WordPress to the browser through WebAssembly — a place where anyone can experiment, test, and build with WordPress instantly. -We’re excited to have you here, and everyone is welcome to contribute. +Playground brings WordPress to the browser through WebAssembly — a place where anyone can experiment, test, and build with WordPress instantly. We’re excited to have you here, and everyone is welcome to contribute. --- @@ -22,22 +21,11 @@ Here's a few quickstart guides to get you started: --- ## 🧭 Guidelines - -- As with all WordPress projects, we’re committed to a **welcoming, inclusive, and respectful environment** for everyone. - Please follow our [Code of Conduct](https://make.wordpress.org/handbook/community-code-of-conduct/). - -- Before submitting a pull request, review the - [repository management and pull request best practices](https://wordpress.github.io/wordpress-playground/contributing/code), - and follow the WordPress Playground coding and accessibility standards. - +- As with all WordPress projects, we’re committed to a **welcoming, inclusive, and respectful environment** for everyone. Please follow our [Code of Conduct](https://make.wordpress.org/handbook/community-code-of-conduct/). +- Before submitting a pull request, review the [repository management and pull request best practices](https://wordpress.github.io/wordpress-playground/contributing/code), and follow the WordPress Playground coding and accessibility standards. - WordPress Coding Standards [Coding Standards](https://developer.wordpress.org/coding-standards/wordpress-coding-standards/) -- Before submitting a pull request, review the - -- **Maintain compatibility:** - If your changes affect shared functions, modules, or APIs, ensure they don’t break existing Playground environments or integrations. - -- You maintain copyright over your contributions. - By submitting a pull request, you agree to release your code under [Playground’s License](/LICENSE.md). +- **Maintain compatibility:** If your changes affect shared functions, modules, or APIs, ensure they don’t break existing Playground environments or integrations. +- You maintain copyright over your contributions.By submitting a pull request, you agree to release your code under [Playground’s License](/LICENSE.md). --- From 3f34a6c78d1db63fcd13f9cb7b7753ebe6fc6aa5 Mon Sep 17 00:00:00 2001 From: Md Aminul Islam <56115259+theaminuli@users.noreply.github.com> Date: Sat, 15 Nov 2025 13:50:59 +0600 Subject: [PATCH 05/11] =?UTF-8?q?Clean=20up=20duplicate=20=E2=80=9CReporti?= =?UTF-8?q?ng=20bugs=E2=80=9D=20links?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Fellyph Cintra --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 75e376e116..3132d76067 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -15,7 +15,7 @@ Here's a few quickstart guides to get you started: - Documentation – see the [documentation section](https://wordpress.github.io/wordpress-playground/docs/contributing/documentation). - Triage – see the [triage section](https://wordpress.github.io/wordpress-playground/contributing/#triaging-issues). - Contributions to translations – see the [translations section](https://wordpress.github.io/wordpress-playground/contributing/translations). -- Reporting bugs – open an [issue](https://github.com/WordPress/wordpress-playground/issues/new) in the repository. +- Reporting bugs – open an [issue](https://github.com/WordPress/wordpress-playground/issues/new/choose) in the repository. - Ideas, designs or anything else – open a [GitHub discussion](https://github.com/WordPress/wordpress-playground/discussions) and let's talk! --- From d13fcfa2f2be1dd13067bc628bc3c32672b60c69 Mon Sep 17 00:00:00 2001 From: Md Aminul Islam <56115259+theaminuli@users.noreply.github.com> Date: Sat, 15 Nov 2025 13:54:26 +0600 Subject: [PATCH 06/11] Update code-contribution links in documentation Co-authored-by: Fellyph Cintra --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 3132d76067..2aade6de4b 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -11,7 +11,7 @@ WordPress Playground is an open-source project and welcomes all contributors fro Here's a few quickstart guides to get you started: -- Code contributions – see the [developer section](https://wordpress.github.io/wordpress-playground/docs/contributing/code). +- Code contributions – see the [developer section](https://wordpress.github.io/wordpress-playground/contributing/code/). - Documentation – see the [documentation section](https://wordpress.github.io/wordpress-playground/docs/contributing/documentation). - Triage – see the [triage section](https://wordpress.github.io/wordpress-playground/contributing/#triaging-issues). - Contributions to translations – see the [translations section](https://wordpress.github.io/wordpress-playground/contributing/translations). From b1d8d49ab983b52038d32de26bbe495ac5943046 Mon Sep 17 00:00:00 2001 From: Md Aminul Islam <56115259+theaminuli@users.noreply.github.com> Date: Sat, 15 Nov 2025 13:57:42 +0600 Subject: [PATCH 07/11] Correct Documentation section URLs in docs Co-authored-by: Fellyph Cintra --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 2aade6de4b..66d43fc2c4 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -12,7 +12,7 @@ WordPress Playground is an open-source project and welcomes all contributors fro Here's a few quickstart guides to get you started: - Code contributions – see the [developer section](https://wordpress.github.io/wordpress-playground/contributing/code/). -- Documentation – see the [documentation section](https://wordpress.github.io/wordpress-playground/docs/contributing/documentation). +- Documentation – see the [documentation section](https://wordpress.github.io/wordpress-playground/contributing/documentation). - Triage – see the [triage section](https://wordpress.github.io/wordpress-playground/contributing/#triaging-issues). - Contributions to translations – see the [translations section](https://wordpress.github.io/wordpress-playground/contributing/translations). - Reporting bugs – open an [issue](https://github.com/WordPress/wordpress-playground/issues/new/choose) in the repository. From 682160c96caed569e1fbc1be11b377d8de934df8 Mon Sep 17 00:00:00 2001 From: Md Aminul Islam <56115259+theaminuli@users.noreply.github.com> Date: Sat, 15 Nov 2025 13:58:27 +0600 Subject: [PATCH 08/11] Fix grammar in quickstart guides heading Co-authored-by: Fellyph Cintra --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 66d43fc2c4..9ad703aeaf 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -9,7 +9,7 @@ Playground brings WordPress to the browser through WebAssembly — a place where WordPress Playground is an open-source project and welcomes all contributors from code to design, and from documentation to triage. If the feature you need is missing, you are more than welcome to start a discussion, open an issue, and even propose a Pull Request to implement it. -Here's a few quickstart guides to get you started: +Here are a few quickstart guides to get you started: - Code contributions – see the [developer section](https://wordpress.github.io/wordpress-playground/contributing/code/). - Documentation – see the [documentation section](https://wordpress.github.io/wordpress-playground/contributing/documentation). From 33a5851a300d8faededeb761dc5ded27fe583ad2 Mon Sep 17 00:00:00 2001 From: Md Aminul Islam <56115259+theaminuli@users.noreply.github.com> Date: Sat, 15 Nov 2025 14:00:33 +0600 Subject: [PATCH 09/11] Fix spacing in contribution copyright notice Co-authored-by: Fellyph Cintra --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 9ad703aeaf..f18a5906e1 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -25,7 +25,7 @@ Here are a few quickstart guides to get you started: - Before submitting a pull request, review the [repository management and pull request best practices](https://wordpress.github.io/wordpress-playground/contributing/code), and follow the WordPress Playground coding and accessibility standards. - WordPress Coding Standards [Coding Standards](https://developer.wordpress.org/coding-standards/wordpress-coding-standards/) - **Maintain compatibility:** If your changes affect shared functions, modules, or APIs, ensure they don’t break existing Playground environments or integrations. -- You maintain copyright over your contributions.By submitting a pull request, you agree to release your code under [Playground’s License](/LICENSE.md). +- You maintain copyright over your contributions. By submitting a pull request, you agree to release your code under [Playground’s License](/LICENSE.md). --- From cb3309e0b593d7657fd2a3a59275b3b63757fe19 Mon Sep 17 00:00:00 2001 From: Md Aminul Islam <56115259+theaminuli@users.noreply.github.com> Date: Sat, 15 Nov 2025 14:01:47 +0600 Subject: [PATCH 10/11] Correct formatting of Coding Standards reference Co-authored-by: Fellyph Cintra --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index f18a5906e1..bf21bc38b7 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -23,7 +23,7 @@ Here are a few quickstart guides to get you started: ## 🧭 Guidelines - As with all WordPress projects, we’re committed to a **welcoming, inclusive, and respectful environment** for everyone. Please follow our [Code of Conduct](https://make.wordpress.org/handbook/community-code-of-conduct/). - Before submitting a pull request, review the [repository management and pull request best practices](https://wordpress.github.io/wordpress-playground/contributing/code), and follow the WordPress Playground coding and accessibility standards. -- WordPress Coding Standards [Coding Standards](https://developer.wordpress.org/coding-standards/wordpress-coding-standards/) +- [WordPress Coding Standards](https://developer.wordpress.org/coding-standards/wordpress-coding-standards/) - **Maintain compatibility:** If your changes affect shared functions, modules, or APIs, ensure they don’t break existing Playground environments or integrations. - You maintain copyright over your contributions. By submitting a pull request, you agree to release your code under [Playground’s License](/LICENSE.md). From e798d4675af5b678ae22a1534fe0d819cfd48bac Mon Sep 17 00:00:00 2001 From: Md Aminul Islam <56115259+theaminuli@users.noreply.github.com> Date: Sat, 15 Nov 2025 14:04:58 +0600 Subject: [PATCH 11/11] Add connection details for Playground team on Slack --- CONTRIBUTING.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index bf21bc38b7..4de2374c01 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -17,6 +17,7 @@ Here are a few quickstart guides to get you started: - Contributions to translations – see the [translations section](https://wordpress.github.io/wordpress-playground/contributing/translations). - Reporting bugs – open an [issue](https://github.com/WordPress/wordpress-playground/issues/new/choose) in the repository. - Ideas, designs or anything else – open a [GitHub discussion](https://github.com/WordPress/wordpress-playground/discussions) and let's talk! +- Connect with the Playground team at [`#playground` channel on WordPress Slack](https://wordpress.slack.com/archives/C04EWKGDJ0K) ---