expand git intro authored by Malin Freeborn's avatar Malin Freeborn
...@@ -22,6 +22,23 @@ If you modify a weapon and someone else adds a spell, nobody wants to deal with ...@@ -22,6 +22,23 @@ If you modify a weapon and someone else adds a spell, nobody wants to deal with
If you have an idea, but you want to show it to someone before committing to it, git lets you make a copy of the project, then give someone your copy and your new ideas. They can then make changes before putting it into the book. If you have an idea, but you want to show it to someone before committing to it, git lets you make a copy of the project, then give someone your copy and your new ideas. They can then make changes before putting it into the book.
## Setup
Setting up git it easy.
Just install `git` with your package manager (probably `sudo apt install git`) then give it the same username and email as you use on Github.
```bash
git config --global user.name "Your Unchanging Name"
git config --global user.email "email@eternal.tld"
```
You don't need to use your real name, but you do need to keep a consistent name and email.
Your email will be public, and is used for people to ask why you made a particular change, in case your notes are not clear.
If you're sure you don't want to use your real email address, use `bindrpg@posteo.uk` instead.
## Basic Usage
`git` gives you a lot of toys, but beginners will only need a few: `git` gives you a lot of toys, but beginners will only need a few:
Make a new branch to play with, and name it something (in this example, your username). Make a new branch to play with, and name it something (in this example, your username).
... ...
......