mirror of
https://github.com/privacyguides/privacyguides.org.git
synced 2024-12-18 12:24:35 -05:00
4bd9c6ca20
Signed-off-by: blacklight447 <niek@privacyguides.org> Signed-off-by: kimg45 <138676274+kimg45@users.noreply.github.com> Signed-off-by: Daniel Gray <dngray@privacyguides.org>
79 lines
2.5 KiB
Markdown
79 lines
2.5 KiB
Markdown
---
|
|
title: Commit Messages
|
|
description: A guide for website contributors on using useful Git commit messages when making website change requests.
|
|
---
|
|
|
|
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:
|
|
|
|
## Update to existing text
|
|
|
|
This example could be used for an item already on the site, but includes a minor update to the description.
|
|
|
|
```text
|
|
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.
|
|
|
|
```text
|
|
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:
|
|
|
|
```text
|
|
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.
|
|
|
|
```text
|
|
style: Typo correction in VPN overview
|
|
```
|
|
|
|
## Development-related types
|
|
|
|
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.
|
|
|
|
```text
|
|
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`:
|
|
|
|
```text
|
|
docs: Update Git commit message guidelines (#0000)
|
|
```
|
|
|
|
We use `build:` for commits related to our build process, mainly dependency updates.
|
|
|
|
```text
|
|
build: Bump modules/mkdocs-material from 463e535 to 621a5b8
|
|
```
|
|
|
|
We use `ci:` for commits related to GitHub Actions, DevContainers, or other automated build platforms.
|
|
|
|
```text
|
|
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.
|
|
|
|
```text
|
|
refactor: Move docs/assets to theme/assets
|
|
```
|