Last Updated on June 7, 2025 by Neil Murray

1. Setup for WordPress Contribution #

back to top

• Prerequisites
• Local WordPress Environment – using Docker and wp-env
• Local WordPress Environment – existing WordPress environment
• Setup wp-env
• Gutenberg – fork, clone, commit
• Using Studio
• nvm – Node version manager
• Using Docker
• Using Xdebug

Refer: Setup for WordPress Contribution

Prerequisites #

Refer:

• Getting Started With Code Contribution – Prerequisites
• Setup for WordPress Contribution – Prerequisites

back to top

Local WordPress Environment – using Docker and wp-env #

Refer:

• Getting Started With Code Contribution – Local WordPress Environment
• Setup for WordPress Contribution – Using Docker and wp-env

back to top

Local WordPress Environment – existing WordPress environment #

Refer:

• Getting Started With Code Contribution – Getting the Gutenberg code:
• Using existing WordPress environment

back to top

Further reading:

• Setup wp-env
• Gutenberg – fork, clone, commit
• nvm – Node version manager
• Using Docker
• Using Xdebug

back to top

2. Key skills you need to learn #

back to top

• Pull Requests

Pull Requests #

back to top

Refer: Pull requests

Refer: 

• Pull requests – Code review
• How To Get Your Pull Request Reviewed?

Refer: Pull requests – Design review

Refer: 

• Pull requests – Merging pull requests
• Keeping your branch up to date
• Squash commits on branch before merge

Refer: Pull requests – Closing pull requests

Further Reading:

• Repository Management – Pull requests
• How To Get Your Pull Request Reviewed?
• How to Fork a Repository, Make Changes, and Submit a Pull Request on GitHub

back to top

3. Gutenberg Code Contributions #

back to top

• Repository management
• Git Workflow
• Keeping your branch up to date
• Coding Guidelines

Repository management #

back to top

• Issue Management
• Teams and Projects

Issue Management #

Refer: Repository Management – Issues

Teams and Projects #

Refer: Teams & Projects

back to top

Git Workflow #

back to top

Refer: Repository Management

Refer: Git Workflow Walkthrough

Refer: Branch naming

Refer: Keeping your branch up to date

Refer: Keeping your fork up to date

Refer: Git Workflow

back to top

Coding Guidelines #

• CSS
• JavaScript
  • JavaScript documentation using JSDoc
• PHP

Refer: Coding Guidelines

back to top

4. Gutenberg Testing #

back to top

• Writing Tests
• Gutenberg Testing
• Get Setup for Testing
• Testing Bugs
• Accessibility Testing

Writing Tests #

Refer: Writing Tests

back to top

Gutenberg Testing #

Refer: Gutenberg Testing

back to top

Get Setup for Testing #

Refer: Get Setup for Testing

back to top

Testing Bugs #

Refer: Testing Bugs

back to top

Accessibility Testing #

Refer: Accessibility Testing

back to top

5. Communicating with Gutenberg Team #

Real-time discussions for development take place in #core-editor and #core-js channels in Make WordPress Slack (registration required).

Weekly meetings for the editor component are on Wednesdays at 14:00UTC, and for the JavaScript component on Tuesday at 15:00UTC, in their respective Slack channels.

Readme links:

• Make WordPress Core blog
• Make WordPress Slack 

back to top

Further reading:

• Item

back to top

---

Notes

ADD notes here.

Save all Images to Sync – use ..\Sync\..\Form API\Guidelines\Form API – step by step instructions\