Update readme.md

1 files changed, 14 insertions, 1 deletions

diff --git a/keyboard/ergodox_ez/keymaps/maz/readme.md b/keyboard/ergodox_ez/keymaps/maz/readme.md
index da50731ae..b382e8916 100644
--- a/keyboard/ergodox_ez/keymaps/maz/readme.md
+++ b/keyboard/ergodox_ez/keymaps/maz/readme.md
@@ -1,6 +1,19 @@
+# Introduction
 
-# Keymap
+## Motivation
+I created this keymap in an attempt to optimize my typing experience in text editors and the command-line.
+
+More specifically, I wanted to have each modifier key controlled by the thumbs, the most powerful of the digits (I think). This cured me of emacs pinky, which had surprisingly grown quite quickly over the first two weeks of using emacs & emacs-like commands on the command-line.
+
+## Changes
+The biggest changes from the ergodox ez default keymap are the modifiers on the thumb cluster.
 
+## Caveats
+I've heard many complaints about the thumb clusters. I agree that the three outter keys are almost impossible to reach. I am going to try to build [Matt Adereth's keyboard][https://github.com/adereth/dactyl-keyboard], which looks to have a better layout. However, I am able to comfortably use the three modifier keys mainly because:
+* I use DCS keycaps with SA Row 3 keycaps where the Alt keys are
+* I have relatively large hands (I guarantee you there's no problem; I guarantee you)
+
+# Keymap
 ## Keymap 0: Basic layer
 ```
  ,--------------------------------------------------.           ,--------------------------------------------------.