diff --git a/README.md b/README.md
index 07f6940..2a956f9 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,59 @@
 # Keyboard Collection
 
+I like ergonomic keyboards. This is a repo where I can dump my keyboard stuff.
+
 ## Primary - Atreus (technomancy kit)
 
-## Backup - Moonlander Mark II
+![atreus keyboard](./docs/images/atreus.jpg)
+
+| Switches | Keycaps | Layout |
+| ---------|---------|--------|
+| Outemu Silent Gray | Currently borrowed from Ergodox + random grab bag caps from Signature Plastics' grab bag | QWERTY + 2 layers for MapleStory |
+
+
+I actually bought this [kit back in 2020 from Phil](https://atreus.technomancy.us/) and just finally got around to build it in 2024. It's one of the last kits he sold before the Atreus found a [home at Keyboardio](https://shop.keyboard.io/products/keyboardio-atreus). 
+
+ I really like this board. It's small enough to that I could put in my back pocket. I don't because I don't want to get beat up. It sports a layer where a full numpad is under your right hand and similarly-mapped layer for the F-keys.
+ 
+ This was the first keyboard where I re-lubed each switch. It feels really great to type on, very little friction with the proper amount of feedback and zero sound to annoy my office mates.
+
+This board can be configured using online [QMK's Configurator](https://config.qmk.fm/#/atreus/astar/LAYOUT_pcb_up) Files for this are in `./atreus`.
+
+My husband helped me develop layers 3 and 4, which are designed to be used for keybindings in a MMORPG called MapleStory. I am not really a gamer but we decided to try this game to get my feet wet and to have a shared interest.
+
+## Backup - ZSA Moonlander Mark I
+
+![moonlander keyboard](./docs/images/moonlander.jpg)
+
+| Switches | Keycaps | Layout |
+| ---------|---------|--------|
+| Cherry Brown | Default Black | QWERTY default |
+
+I rocked the Moonlander Mark II for a while. It's a good "big". I think my main complaint ended up being the cable clutter. The two halves were joined by a TRRS connector and the left side had a USB-C connector to the PC.
+
+Left this board mostly stock, the default layout was good nuff for daily driving. Once I finally got off my butt to build the Atreus, I tagged the Moonlander out.
+
+https://www.zsa.io/moonlander
 
 ## Shelved - Ergodox
+(Write-up coming soon)
+
+## Planned: MK-44
+TBD
+
+## Planned: 3D-printed Atreus variant
+TBD
+
+# Reference
+
+## Sites
+ - [Keyboardio](https://shop.keyboard.io/products/)
+ - [QMK Firmware](https://qmk.fm/)
+ - [Milktooth (switches)](https://milktooth.com/)
+ - [Signature Plastics](https://spkeyboards.com/)
+
+## Keycaps
+I can never remember keycap profiles, so putting this here:
+
+![Keycap Profile from TheKapCo](./docs/images/thekapco-keycap-profiles.png)
 
-## Planned
- - 3D-printed Atreus Variant
- - MB-44 
diff --git a/docs/images/atreus.jpg b/docs/images/atreus.jpg
new file mode 100644
index 0000000..e773689
Binary files /dev/null and b/docs/images/atreus.jpg differ
diff --git a/docs/images/moonlander.jpg b/docs/images/moonlander.jpg
new file mode 100644
index 0000000..89d4e4a
Binary files /dev/null and b/docs/images/moonlander.jpg differ