Title: Documentation contributions
Published: July 15, 2026
Last modified: July 16, 2026

---

# Documentation contributions

## In this article

 * [How can I contribute?](https://developer.wordpress.org/playground/handbook/contributing/documentation/?output_format=md#how-can-i-contribute)
    - [Forking the repo, edit files locally and opening Pull Requests](https://developer.wordpress.org/playground/handbook/contributing/documentation/?output_format=md#forking-the-repo-edit-files-locally-and-opening-pull-requests)
    - [Edit in the browser](https://developer.wordpress.org/playground/handbook/contributing/documentation/?output_format=md#edit-in-the-browser)
    - [Local preview](https://developer.wordpress.org/playground/handbook/contributing/documentation/?output_format=md#local-preview)

[ Back to top](https://developer.wordpress.org/playground/handbook/contributing/documentation/?output_format=md#wp--skip-link--target)

[WordPress Playground’s documentation site](https://developer.wordpress.org/playground/)
is maintained by volunteers like you, who’d love your help.

All documentation-related issues are labeled [`[Type] Documentation`](https://github.com/WordPress/wordpress-playground/issues?q=is%3Aissue%20state%3Aopen%20label%3A%22%5BType%5D%20Documentation%22)
or [`[Type] Developer Documentation`](https://github.com/WordPress/wordpress-playground/issues?q=is%3Aissue%20state%3Aopen%20label%3A%22%5BType%5D%20Developer%20Documentation%22)
in the [WordPress/wordpress-playground](https://github.com/WordPress/wordpress-playground)
repository. Browse the list of open issues to find one you’d like to work on. Alternatively,
if you believe something is missing from the current documentation, open an issue
to discuss your suggestion.

## 󠀁[How can I contribute?](https://developer.wordpress.org/playground/handbook/contributing/documentation/?output_format=md#how-can-i-contribute)󠁿

You can contribute by [opening an issue in the project repository](https://github.com/WordPress/wordpress-playground/issues/new)
and describing what you’d like to add or change.

If you feel up to it, write the content in the issue description, and the project
contributors will take care of the rest.

Would you like to see the documentation in your language? Check the [Translation section](https://developer.wordpress.org/playground/contributing/translations).

### 󠀁[Forking the repo, edit files locally and opening Pull Requests](https://developer.wordpress.org/playground/handbook/contributing/documentation/?output_format=md#forking-the-repo-edit-files-locally-and-opening-pull-requests)󠁿

If you are familiar with markdown, you can [fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo)
the `wordpress-playground` repo and propose changes and new documentation pages 
by submitting a Pull Request.

The process of creating a branch to open new PRs with translated pages on the [WordPress/wordpress-playground](https://github.com/WordPress/wordpress-playground)
repository is the same as contributing to other WordPress repositories such as Gutenberg:

> [Git Workflow](https://developer.wordpress.org/block-editor/contributors/code/git-workflow/)

The documentation files (`.md` files) are stored in Playground’s GitHub repository,
[under `/packages/docs/site/docs`](https://github.com/WordPress/wordpress-playground/tree/trunk/packages/docs/site/docs)
for English and [`/packages/docs/site/i18n`](https://github.com/WordPress/wordpress-playground/tree/trunk/packages/docs/site/i18n)
for other languages.

### 󠀁[Edit in the browser](https://developer.wordpress.org/playground/handbook/contributing/documentation/?output_format=md#edit-in-the-browser)󠁿

If logged in GitHub, you can also edit existing files (or add new ones) and submit
a PR directly from the GitHub UI:

 1. Find the page you’d like to edit or the directory of the chapter you’d like to 
    add a new page to.
 2. Click the **Add Files** button to add a new file, or click on an existing file 
    and then click the pencil icon to edit it.
 3. GitHub will ask you to fork the repository and create a new branch with your changes.
 4. An editor will open where you can make the changes.
 5. When you’re done, click the **Commit Changes** button and submit a Pull Request.

That’s it! You’ve just contributed to the WordPress Playground documentation.

This approach means you don’t need to clone the repository, set up a local development
environment, or run any commands.

The downside is that you won’t be able to preview your changes. Keep reading to 
learn how to review your changes before submitting a Pull Request.

### 󠀁[Local preview](https://developer.wordpress.org/playground/handbook/contributing/documentation/?output_format=md#local-preview)󠁿

Clone the repository and navigate to the directory on your device. Now run the following
commands:

    ```bash
    npm install
    npm run build:docs
    npm run dev:docs
    ```

The documentation site opens in a new browser tab and refreshes automatically with
each change. Continue to edit the relevant file in your code editor and test the
changes in real-time.

First published

July 15, 2026

Last updated

July 16, 2026

Edit article

[ Improve it on GitHub: Documentation contributions ](https://raw.githubusercontent.com/WordPress/wordpress-playground/trunk/packages/docs/site/docs/main/contributing/documentation.md)

Changelog

[ See list of changes: Documentation contributions ](https://developer.wordpress.org/playground/handbook/contributing/documentation/?output_format=md#)

[  Previous: Contributor Day Table Leadership Guide](https://developer.wordpress.org/playground/handbook/contributing/contributor-day-table-lead/)

[  Next: Contributions to translations](https://developer.wordpress.org/playground/handbook/contributing/translations/)