nix-config/git/README.md

# Git

[Git][git] is the standard version control tool.

# Use Cases

Git can be used to:

- Keep track of file changes over time
- Keep a record of all contributors to a code base
- Rollback to a previous version of a project
- Create snapshots of a project with tags (also known as versions)

You should not use Git if:

- You are dealing with binary files
- You are dealing with large files that change often

## Usage

First, install [diff-so-fancy][diff-so-fancy], an amazing git diff utility.

Then, create a `~/.gituser` with the following:

```gitconfig
[user]
  name = <the name you use for git commits>
  email = <the email you use for git commits>
  signingkey = <the subkey you use to sign git commits>
```

[git]: https://github.com/git/git
[diff-so-fancy]: https://github.com/so-fancy/diff-so-fancy
docs: Add READMEs for git, plasma, and tmux Whether or not Plasma-specific dotfiles are still needed is questionable, but I will keep this directory for now. 2018-10-23 20:25:08 +02:00			`# Git`

misc: Update wording Some minor changes here that don't affect anything. 2018-11-28 01:00:11 +01:00			`[Git][git] is the standard version control tool.`
docs: Add READMEs for git, plasma, and tmux Whether or not Plasma-specific dotfiles are still needed is questionable, but I will keep this directory for now. 2018-10-23 20:25:08 +02:00
docs: Update READMEs for fish, git, and tmux This is the start of a process to change the old READMEs to the new format. 2018-11-20 03:58:18 +01:00			`# Use Cases`
docs: Add READMEs for git, plasma, and tmux Whether or not Plasma-specific dotfiles are still needed is questionable, but I will keep this directory for now. 2018-10-23 20:25:08 +02:00
docs: Update READMEs for fish, git, and tmux This is the start of a process to change the old READMEs to the new format. 2018-11-20 03:58:18 +01:00			`Git can be used to:`
docs: Add READMEs for git, plasma, and tmux Whether or not Plasma-specific dotfiles are still needed is questionable, but I will keep this directory for now. 2018-10-23 20:25:08 +02:00
docs: Update READMEs for fish, git, and tmux This is the start of a process to change the old READMEs to the new format. 2018-11-20 03:58:18 +01:00			`- Keep track of file changes over time`
			`- Keep a record of all contributors to a code base`
			`- Rollback to a previous version of a project`
			`- Create snapshots of a project with tags (also known as versions)`
docs: Add READMEs for git, plasma, and tmux Whether or not Plasma-specific dotfiles are still needed is questionable, but I will keep this directory for now. 2018-10-23 20:25:08 +02:00
docs: Update READMEs for fish, git, and tmux This is the start of a process to change the old READMEs to the new format. 2018-11-20 03:58:18 +01:00			`You should not use Git if:`

			`- You are dealing with binary files`
			`- You are dealing with large files that change often`
docs: Add READMEs for git, plasma, and tmux Whether or not Plasma-specific dotfiles are still needed is questionable, but I will keep this directory for now. 2018-10-23 20:25:08 +02:00
			`## Usage`

docs: Update READMEs for fish, git, and tmux This is the start of a process to change the old READMEs to the new format. 2018-11-20 03:58:18 +01:00			`First, install [diff-so-fancy][diff-so-fancy], an amazing git diff utility.`

			Then, create a `~/.gituser` with the following:
docs: Add READMEs for git, plasma, and tmux Whether or not Plasma-specific dotfiles are still needed is questionable, but I will keep this directory for now. 2018-10-23 20:25:08 +02:00
			```gitconfig
			`[user]`
			`name = <the name you use for git commits>`
			`email = <the email you use for git commits>`
			`signingkey = <the subkey you use to sign git commits>`
			```

docs: Update READMEs for fish, git, and tmux This is the start of a process to change the old READMEs to the new format. 2018-11-20 03:58:18 +01:00			`[git]: https://github.com/git/git`
			`[diff-so-fancy]: https://github.com/so-fancy/diff-so-fancy`