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>
45 lines
1.9 KiB
Markdown
45 lines
1.9 KiB
Markdown
---
|
|
title: Git Recommendations
|
|
description: A guide for website contributors on using Git effectively.
|
|
---
|
|
If you make changes to this website on GitHub.com's web editor directly, you shouldn't have to worry about this. If you are developing locally and/or are a long-term website editor (who should probably be developing locally!), consider these recommendations.
|
|
|
|
## Enable SSH Key Commit Signing
|
|
|
|
You can use an existing SSH key for signing, or [create a new one](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent).
|
|
|
|
1. Configure your Git client to sign commits and tags by default (remove `--global` to only sign by default for this repo):
|
|
|
|
```bash
|
|
git config --global commit.gpgsign true
|
|
git config --global gpg.format ssh
|
|
git config --global tag.gpgSign true
|
|
```
|
|
|
|
2. Set your SSH key for signing in Git with the following command, substituting `/PATH/TO/.SSH/KEY.PUB` with the path to the public key you'd like to use, e.g. `/home/user/.ssh/id_ed25519.pub`:
|
|
|
|
```bash
|
|
git config --global user.signingkey /PATH/TO/.SSH/KEY.PUB
|
|
```
|
|
|
|
Ensure you [add your SSH key to your GitHub account](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account#adding-a-new-ssh-key-to-your-account) **as a Signing Key** (as opposed to or in addition to as an Authentication Key).
|
|
|
|
## Rebase on Git pull
|
|
|
|
Use `git pull --rebase` instead of `git pull` when pulling in changes from GitHub to your local machine. This way your local changes will always be "on top of" the latest changes on GitHub, and you avoid merge commits (which are disallowed in this repo).
|
|
|
|
You can set this to be the default behavior:
|
|
|
|
```bash
|
|
git config --global pull.rebase true
|
|
```
|
|
|
|
## Rebase from `main` before submitting a PR
|
|
|
|
If you are working on your own branch, run these commands before submitting a PR:
|
|
|
|
```bash
|
|
git fetch origin
|
|
git rebase origin/main
|
|
```
|