diff --git a/README.md b/README.md
index f35679d..703fc0d 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,10 @@
 # dotfiles
 
-A repo containing all my dotfiles.
\ No newline at end of file
+This repo contains the various dotfiles I use on my machines.
+
+# List of contents
+
+This repo contains the following configuration files:
+
+* `.config/ion/initrc`: init file for the [Ion shell](https://github.com/redox-os/ion)
+* `.config/picom.conf`: used for the Picom compositor