diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a4dc240
--- /dev/null
+++ b/README.md
@@ -0,0 +1,6 @@
+# dotfiles
+
+Contains .dotfiles for my debian and void distros.
+Clone and `ln -s` the applicable files to the distro agnotic filenames. e.g.:
+
+`ln -s .void.bashrc .bashrc`