diff --git a/README.md b/README.md
index 5750b7d15..95bfd7066 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,47 @@
 # My Mac Configuration
-I'm documenting this for personal use. Shell settings, vim settings, commonly used applications, et cetera...
+I'm documenting this primarily for personal use. This reposity contains shell configs, vim configs, emacs configs, a list of commonly used applications, and other items.
+
+The overall goal of this repository is to reduce the time it takes to adopt a new computer and equip it with the necessary tooling to do meaningful work.
+
+
+# Neovim
+
+The following snippet fixes the `<C-h>` issue in neovim on macOS.
+
+```
+$ infocmp $TERM | sed 's/kbs=^[hH]/kbs=\\177/' > $TERM.ti
+$ tic $TERM.ti
+```
+
+
+## Italics in tmux and vim
+
+In the file `/configs/.tmux.conf` there is a line to add italics support to tmux:
+
+```
+set -g default-terminal "tmux-256color-italic"
+```
+
+The `$TERM` entry, `tmux-256color-italic`, will be unavailable until you add the file, `/configs/tmux-256color-italic`, to your terminal database. You can do this with the following command:
+
+```bash
+$ tic ~/pc_settings/configs/tmux-256color-italic
+```
+
+
+## Ligature Support
+
+To support ligatures make sure Hasklig is installed (link at the bottom). Ensure that you are using an iTerm 2 build that supports ligatures. With both of these tasks completed, ligatures should function in Neovim.
+
 
 ### Commonly used applications
+* dash - provides quick access to offline documentation (use with Alfred)
+* Alfred - replaces macOS Spotlight and integrates with external Apps like Dash
 * homebrew - necessary for procuring shell applications
 * karabiner - `key-repeat: 50ms delay-until-repeat: 300ms` increase your Mac's key repeat settings beyond the default range
 * spectacle - resize and move your windows with keyboard shortcuts
 * iterm - substitute for Terminal application
-* oh my zsh - z-shell for Mac
+* oh my zsh - a full suite of z-shell extensions
 * sublime text - text editor
 * webstorm - web IDE
 * pycharm - python IDE