Skip to content

Commit

Permalink
Initial docs stub
Browse files Browse the repository at this point in the history
  • Loading branch information
getdave committed Jan 22, 2024
1 parent d7bba1b commit e94967b
Showing 1 changed file with 33 additions and 0 deletions.
33 changes: 33 additions & 0 deletions docs/contributors/code/back-merging-to-wp-core.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# Back Merging code to WordPress Core

For major releases of the WordPress software, Gutenberg features need to be merged into WordPress Core. Typically this involves taking changes made in `.php` files within the Gutenberg repository and making the equivalent updates in the WP Core codebase.

## Files/Directories

Changes to files within the following files/directories will typically require back-merging to WP Core:

- `lib/`
- `phpunit/`

## Ignored directories/files

The following directories/files do _not_ require back-merging to WP Core:

- `lib`
- `load.php` - Plugin specific code.
- `experiments-page.php` - experiments are Plugin specific.
- `packages`
- `block-library` - this is handled automatically during the packages sync process.
- `e2e-tests/plugins` - PHP files related to e2e tests only. Mostly fixture data generators.
- ## `phpunit`

Please note this list is not exhaustive.

## Pull Request Criteria

In general, all PHP code committed to the Gutenberg repository since the date of the final Gutenberg release that was included in [the _last_ stable WP Core release](https://developer.wordpress.org/block-editor/contributors/versions-in-wordpress/) should be considered for back merging to WP Core.

There are however certain exceptions to that rule. PRs with the following criteria do _not_ require back-merging to WP Core:

- Does not contain changes to PHP code.
- Has label `Backport from WordPress Core` - this code is already in WP Core.

0 comments on commit e94967b

Please sign in to comment.