diff --git a/README.md b/README.md
index 055ea82..4f5569e 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,17 @@
-# dot files
-Dotfiles collection
+# README
 
-## Usage
-To setup vim just run the setup script
+You can find my dotfiles collection in here. Feel free to use and share them. 
 
+# Tmux settings
+.tmux.conf is a fork of https://github.com/gpakosz/.tmux conf file. 
+.tmux.conf.local is where you add your settings and overrides.
+Use both.
+
+# Vim settings
+Vimrc uses the **wombat256mod.vim** colorscheme. You can download it from the offical report of from this repo.
+Some of my python editing settings are in the vimrc. The pylint settings are here - search for **g:pymode_lint_**.
+
+
+# TODO
+
+Add documentation