Commit Messages

For our commit messages we follow the style provided by Conventional Commits. Not all of those suggestions are appropriate for Privacy Guides, so the main ones we use are:

Update to existing text¶

This example could be used for an item already on the site, but includes a minor update to the description.

update: Add mention of security audit (#0000)

Addition or removal of recommendations/pages¶

This example is for the addition or removal of an item. You may elaborate why it was removed in the commit paragraph below. Note the extra ! to draw attention to a major change.

update!: Remove foobar (#0000)

Foobar was removed due to it having numerious security issues and being unmaintained.

You can actually add a ! to any of the types on this page to denote particularly large changes, but this is generally where it will be most appropriate.

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:

feat: Add blah blah (#0000)

This change adds the forum topics to the main page

Minor changes¶

Small changes that don't affect the meaning of the article, e.g. correcting a typo, fixing grammar, changing formatting/whitespace, CSS updates, etc.

style: Typo correction in VPN overview

These commit types are typically used for changes that won't be visible to the general audience.

We use fix: for changes that fix site related bugs. These things will usually have the bug label on GitHub.

fix: Remove broken Invidious embeds (#0000)

We use docs: to denote changes to the developer documentation for this website, including (but not limited to) for example the README file, or most pages in /docs/about or /docs/meta:

docs: Update Git commit message guidelines (#0000)

We use build: for commits related to our build process, mainly dependency updates.

build: Bump modules/mkdocs-material from 463e535 to 621a5b8

We use ci: for commits related to GitHub Actions, DevContainers, or other automated build platforms.

ci: Update Netlify config (#0000)

We use refactor: for changes which neither fix a bug nor add a feature, e.g. rearranging files, navigation order, etc.

refactor: Move docs/assets to theme/assets

Share this website and spread privacy knowledge

Copy this text to easily share Privacy Guides with your friends and family on any social network!