Document dotfiles

content/docs/software/linux.adoc

@@ -6,6 +6,34 @@
 
 == Linux
 
+=== Dotfiles
+
+I store my dotfiles in Git so I can easily keep track of
+changes and sync them between devices.
+
+To do so I create a bare git repository in my home directory,
+and configure it to not show untracked files:
+
+[source]
+----
+cd $HOME
+git init --bare $HOME/.dotfiles
+git --git-dir=$HOME/.dotfiles config --local status.showUntrackedFiles no
+----
+
+I then have the following in my `.bash_aliases` to make it easier to
+interact with when I want to perform git operations:
+
+[source,bash]
+----
+# dotfiles
+alias config='/usr/bin/git --git-dir=$HOME/.dotfiles/ --work-tree=$HOME'
+----
+
+Some of my dotfiles have API keys and other semi-sensitive bits and bobs,
+so I encrypt the entire repository with
+https://github.com/spwhitton/git-remote-gcrypt[git-remote-gcrypt].
+
 === Random commands
 
 Split some pages from a PDF::