-
-
Notifications
You must be signed in to change notification settings - Fork 207
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
update: Commit recommendations meta page (#2604)
Signed-off-by: redoomed1 <[email protected]> Signed-off-by: Jonah Aragon <[email protected]>
- Loading branch information
Showing
2 changed files
with
50 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,49 @@ | ||
--- | ||
title: Commit Messages | ||
--- | ||
|
||
For our commit messages we follow the style provided by [Conventional Commits](https://conventionalcommits.org). Not all of those suggestions are appropriate for Privacy Guides, so the main ones we use are: | ||
|
||
## Commit message with correction | ||
|
||
We use `fix` for simple things like spelling mistakes or site related bugs. These things will usually have the `correction` or `bug` label on GitHub. | ||
|
||
```text | ||
fix: Correct spelling on XYZ page (#0000) | ||
``` | ||
|
||
## Update to site | ||
|
||
This example is for a removal of an item (but could also be used for an addition); you may elaborate why it was removed in the commit paragraph below. It can also be used for the addition of any new pages. | ||
|
||
```text | ||
update: Remove foobar (#0000) | ||
Foobar was removed due to it having numerious security issues and being unmaintained. | ||
``` | ||
|
||
## Update to specific item | ||
|
||
This example could be used for an item already on the site, but includes a minor update to the description. | ||
|
||
```text | ||
foobar: Add mention of security audit (#0000) | ||
``` | ||
|
||
## Feature/enhancement | ||
|
||
For new features or enhancements to the site, e.g. things that have the `enhancements` label on GitHub, it may be appropriate to signify these with: | ||
|
||
```text | ||
feat: Add blah blah (#0000) | ||
This change adds the forum topics to the main page | ||
``` | ||
|
||
## Module update | ||
|
||
Dependency updates follow the normal recommendations of beginning with: | ||
|
||
```text | ||
chore: Bump modules/mkdocs-material from 463e535 to 621a5b8 | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters