diff --git a/README b/README
deleted file mode 100644
index a562702..0000000
--- a/README
+++ /dev/null
@@ -1,9 +0,0 @@
-dot
-===
-
-dotfiles for randomuser
-if they work, great
-if they don't, I don't care
-
-there's now a hack that allows you to have your bashrc
-and profile in your $XDG_CONFIG_DIR, or ~/.config
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5fc4316
--- /dev/null
+++ b/README.md
@@ -0,0 +1,26 @@
+randomuser's dotfiles
+=====================
+
+here's some dotfiles!
+
+some features
+
+- ``bspwm`` + ``sxhkd``
+- ``tmenu``: terminal based ``dmenu`` replacement
+- uses ``pash``, the password manager
+- no flakes (can't figure it out, lol)
+
+some future things to work on are
+
+- remove ``polybar`` with a simpler, homegrown solution
+- integrate a dynamic color switching mechanism
+	- make these more appealing, in general
+	- without compromising speed and system load
+- compatibility with 'traditional' unix systems
+
+license.
+
+- boring legal stuff for most items in this configuration are in the LICENSE file.
+	- under the GPLv3
+	- everything under ``config/*``, ``builds/*``, and ``modules/*``, in addition to all files that are ``*.nix``.
+	- NOT in ``wallpapers/*``, those are unlicensed and their legal status is unknown