docs: ✏️ Update

Author: maatthc

README.md

@@ -1,14 +1,27 @@
 #   My QMK keyboard layout
 
-Based on Miryoku Layout
+This is a QWERTY Miryoku-inspired layout optimized for ergonomics.
+
+It's a Split 3x6_3 with the outer columns dedicated to Window management shortcuts.
+
+It features:
+
+- Predictive Tap Hold: Faster tap/hold decisions
+- Home row mods 
+- Layer-tap keys: Hold thumb keys to access layers, tap for the base key
+- Raw HID: Layer state communication to a companion app
+
+Remember:
 
 - Don’t connect or disconnect the TRRS cable when the keyboard is powered. Always disconnect the USB cable first.
-- Flash the firmware on both Raspberry Pi Picos.
-- Enter the bootloader mode by holding down the BOOTSEL button while reconnecting the board into USB port.
+- Flash the firmware on both sides.
 
-https://github.com/beekeeb/piantor
+![Base Layout](./data/layers/miryoku-kle-base.png)
 
-https://github.com/qmk/qmk_firmware/tree/master/keyboards/beekeeb/piantor
+## Keyboards
+
+- [ Piantor ](./keyboards/beekeeb/piantor/readme.md)
+- [ Corne ](./keyboards/crkbd/rev1/readme.md)
 
 ## Keyboard Layers App companion
 
@@ -33,32 +46,45 @@ Details here: https://github.com/maatthc/miryoku_qmk_app
 - Set up QMK:
 `cd ..; qmk setup`
 
-### Install old GCC 8.3.0
-Reduces size considerably (~1.5k):
+#### Piantor
+```
+export KEYBOARD="beekeeb/piantor"
+```
+#### Corne 
+
+```
+export KEYBOARD="crkbd/rev1"
+```
 
-`./install_avr_8.3.0.sh`
-export PATH=${HOME}/avr_toolchain/bin:$PATH
+##### Compile with GCC v8.3.0
+Generates a firmware considerably smaller (~1.5k):
+
+```
+./install_avr_8.3.0.sh
+export PATH=${PWD}/avr_toolchain/bin:$PATH
+```
 
 ### Compile
-`qmk compile -kb beekeeb/piantor -km maat`
+`qmk compile -kb $KEYBOARD -km maat`
 
 ### Flash
-`qmk flash -kb beekeeb/piantor -km maat`
+`qmk flash -kb $KEYBOARD -km maat`
 
-### Generates the clang compile_commands.json
-`qmk compile --compiledb -kb crkbd/rev1 -km maat`
+### Generates the Clang compile_commands.json
+`qmk compile --compiledb -kb $KEYBOARD -km maat`
 
 ### Check debug logs
 `qmk console`
 
 ### info
 
-`qmk info -kb beekeeb/piantor -km maat`
+`qmk info -kb $KEYBOARD -km maat`
 
 ## Configuration
 
-- users/maat/
-- keyboards/beekeeb/piantor/keymaps/maat/
+- ./users/maat/
+- ./keyboards/beekeeb/piantor/keymaps/maat/
+- ./keyboards/crkbd/rev1/keymaps/maat/
 
 ### Typing Test
 
@@ -67,21 +93,23 @@ https://config.qmk.fm/#/test
 ### Symbols that correspond to keycodes available in QMK.
 https://docs.qmk.fm/keycodes
 
-## Generated Layout/Layers images
+## All Layers
+
+Definitions (.json) files at: ./data/layers/
 
-Json files and images at: ./data/layers/
+Images generated with [KLE NG](https://editor.keyboard-tools.xyz/)
 
-- ![Base](./data/layers/miryoku-kle-base.png)
+![Base](./data/layers/miryoku-kle-base.png)
 
-- ![Media](./data/layers/miryoku-kle-media.png)
+![Media](./data/layers/miryoku-kle-media.png)
 
-- ![Nav](./data/layers/miryoku-kle-nav.png)
+![Nav](./data/layers/miryoku-kle-nav.png)
 
-- ![Mouse](./data/layers/miryoku-kle-mouse.png)
+![Mouse](./data/layers/miryoku-kle-mouse.png)
 
-- ![Symbols](./data/layers/miryoku-kle-sym.png)
+![Symbols](./data/layers/miryoku-kle-sym.png)
 
-- ![Numbers](./data/layers/miryoku-kle-num.png)
+![Numbers](./data/layers/miryoku-kle-num.png)
 
-- ![Fun](./data/layers/miryoku-kle-fun.png)
+![Functions](./data/layers/miryoku-kle-fun.png)