diff --git a/.vortex-core/README.md b/.vortex-core/README.md
index 0709448..406be3b 100644
--- a/.vortex-core/README.md
+++ b/.vortex-core/README.md
@@ -1,5 +1,17 @@
-# Vortex core
+# Keyboard configuration
 
-Generated from [TsFreddie's MPC tool](https://tsdo.in/much-programming-core/)
+Keyboard configuration for the Vortex Core 40% keyboard.
 
-![](layout.png)
+Generated using [TsFreddie's MPC tool](https://tsdo.in/much-programming-core/).
+
+## Layer 0
+
+Macros are mainly used for shift, ctrl & alt modifiers.
+
+![](l0.png)
+
+## Layer 1
+
+Lighting configuration layer with some macros for workspaces.
+
+![](l1.png)