X-Git-Url: https://git.r.bdr.sh/rbdr/dotfiles/blobdiff_plain/9c44ef3fdb6522d7378865001d73205e1975bd0a..ea96719f0f8a48bb2386d4322c28b06744fe43ba:/README.md?ds=inline

diff --git a/README.md b/README.md
index 95f8cd7..3456972 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,55 @@
-dotfiles
-========
+# Dotfiles
 
-My Dot Files
\ No newline at end of file
+To set up run `./install`
+
+It provides configuration for:
+
+* vim / nvim
+* tmux
+* zsh
+* git
+* ctags
+* ripgrep
+* tmuxp
+* kitty
+* karabiner
+* weechat
+* nethack
+* terminfo italics support
+
+## Prerequisites
+
+The scripts here assume either `brew` or `apt` are installed.
+Install brew with: `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`
+
+It might also be a good idea to install the xcode command line tools with `xcode-select --install`
+
+## Provisioning
+
+These dotfiles include some provisioning scripts for `brew` and `apt`.
+
+To set up run `./provision <recipe>` where `<recipe>` is one of:
+
+* `essential`
+* `nice`
+* `cask_essential` (only `brew`)
+* `cask_nice` (only `brew`)
+
+To see what each recipe installs, check the files under `provisioning/`
+
+## Local zshrc
+
+For local modifications to the zshrc create `~/.zshrc.local`.
+
+## Environment modification
+
+In order to specify the environment in the prompt, create a function
+called `env_info_provider` and echo your environment details (eg.
+`dev`, `staging`, `production`)
+
+## CoC & Neovim
+
+Additional scripts are providing for updating extensions in neovim.
+
+After setting up nvim and installing plugins, you can run
+`./add-coc-vim-extensions` to automatically add the extensions.