Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 9 additions & 1 deletion docs/code/developer-workflows.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,14 @@ This guide covers commit conventions, pull request guidelines, and labeling work

This project follows the [Conventional Commits](https://www.conventionalcommits.org/) specification for commit messages and pull request titles.

Format: `<type>: <description>`
Format: `<type>[optional scope][optional !]: <description>`

To signal a **breaking change**, append `!` after the type (and scope, if present):

```
feat!: remove deprecated editor bridge method
fix(api)!: change block serialization format
```

Common types:

Expand Down Expand Up @@ -45,5 +52,6 @@ PRs are automatically labeled based on the Conventional Commits prefix in the ti
| `docs` | `[Type] Developer Documentation` |
| `build`, `ci` | `[Type] Build Tooling` |
| `refactor`, `task`, `chore`, `style` | `[Type] Task` |
| any type with `!` | `[Type] Breaking Change` |

If you manually apply a type label before the automation runs, your choice is respected — the workflow skips re-labeling when a conflicting type label is already present.
3 changes: 2 additions & 1 deletion docs/releases.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,9 +43,10 @@ After the release is created, it is ready for integration into the WordPress app

GitHub automatically generates release notes when a release is created. Notes are organized into the following categories based on PR labels:

- **Breaking Changes** — `[Type] Breaking Change`
- **Features & Enhancements** — `[Type] Enhancement`
- **Bug Fixes** — `[Type] Bug`, `[Type] Regression`
- **Other Changes** — everything else
- **Other Changes** — everything else (excludes `[Type] Automated Testing`, `[Type] Build Tooling`, `[Type] Task`, `[Type] Developer Documentation`, and `dependencies`)

Dependabot dependency bump PRs are excluded automatically.

Expand Down
Loading