diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..09e29d1
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,28 @@
+# nⅤim
+The Ⅴth version of my neovim config. 
+Yet more streamlining and re-working to keep up with how some plugins work
+these days. 
+
+This time instead of copying large swathes of config from my previous
+setup, the majority of this is a clean rewrite, and at current is not fully
+implemented. 
+
+# Currently missing
+
+The current major feature that is missing is I do not have any keybinds set
+up. A lot of the built in ones are enough for general editing. But I need
+to set up some more specific ones for what I actually use.
+
+# Major changes
+Some things that have been removed from the previous config are: 
+## noice 
+While it makes the UI look better, I found that the changes it ended up
+getting in the way of operating my editor the way I normally would.
+
+## Separation of `spec` and `config`
+This at first looks like good practice, separating out the definition of a
+plugin and the configuration means that one file isn't serving two
+different purposes. However actually this just increases the time it takes
+to make changes, as often changes to plugin spec also require some amount
+of change in the plugin config. Also this means that everything relating to
+a single plugin is contained in one place and not spread across two files