Skip to content

Commit

Permalink
update: Commit recommendations meta page (#2604)
Browse files Browse the repository at this point in the history
Signed-off-by: redoomed1 <[email protected]>
Signed-off-by: Jonah Aragon <[email protected]>
  • Loading branch information
dngray committed Jun 3, 2024
1 parent 3d569ae commit 6493cc2
Show file tree
Hide file tree
Showing 2 changed files with 50 additions and 0 deletions.
49 changes: 49 additions & 0 deletions docs/meta/commit-messages.md
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
```
1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -447,6 +447,7 @@ nav:
- !ENV [NAV_TECHNICAL_GUIDES, "Technical Guides"]:
- "meta/uploading-images.md"
- "meta/git-recommendations.md"
- "meta/commit-messages.md"
- !ENV [NAV_DONATE, "Donate"]: "about/donate/"
- !ENV [NAV_CHANGELOG, "Changelog"]:
"https://github.com/privacyguides/privacyguides.org/releases"
Expand Down

0 comments on commit 6493cc2

Please sign in to comment.