diff --git a/README.md b/README.md
index e69de29..70c0fbc 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,8 @@
+# ewpt3ch's dotfiles
+
+#### usage: 
+currently the repo is .dotfiles in ~ with symlinks from the default file to it's corresponding file in the repo. (ie ~/.tmux.conf is a symlink to ~/.dotfiles/tmux.conf) the master branch is files that I want to match on all machines I use (tmux.conf, vimrc, bashrc) and each machine has a branch for customizations specific to that machine. (yoga2 Xresources are different from y410 due to screen resolution).
+
+#### naming conventions
+Kernels: kernel.*machine-name* ie kernel.yoga2
+