diff --git a/README.md b/README.md
index 0283a2b..70c0fbc 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,8 @@
-# Notes
+# ewpt3ch's dotfiles
 
-Master is suitable for normal 96DPI screens
+#### 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
 
-Yoga2 is customized for HiDPI screens