diff --git a/README.md b/README.md
index ea7650c..018df44 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,8 @@
 # dotfiles
 
-general dotfiles
\ No newline at end of file
+## Summary
+
+A repo to track dotfiles for bash and apps I want to keep as portable as possible.  All dotfiles are contained in this
+repo (typically cloned as ~/dotfiles and each file is symlinked to it's default location.  I have added a Makefile to
+create or update each symlink.
+