Update README with more acurate info

10 files changed, 74 insertions, 12 deletions

diff --git a/README.md b/README.md
index 1a1e20b..8be5c57 100644
--- a/README.md
+++ b/README.md
@@ -3,43 +3,105 @@
 The firmware is [Keyberon](https://github.com/TeXitoi/keyberon), a
 pure rust firmware.
 
+The goal was:
+* build a custom keyboard from scratch
+* continue to learn embedded rust
+* have fun
+
+![PouetPouet](images/pouetpouet.jpg)
+![PouetPouet closeup](images/closeup-finish.jpg)
+
 ## Features
 
+ * ortholinear
  * 60 keys, using Cherry MX switches, only 1U keycaps;
+ * 4 RGB LEDs for status;
+ * 6 RGB LEDs for backlight;
  * USB-C connector;
  * 1 STM32F072 MCU, with hardware USB DFU bootloader;
  * Only onboard SMD component (except for the switches).
+ * ESD protection
 
 ## Inspiration
 
- * [Keyseebee](https://github.com/TeXitoi/keyseebee) for being the «I will change it quickly and have something ready in an hour» base project (even if I ended up redoing most of the hardware design).
+ * [Keyseebee](https://github.com/TeXitoi/keyseebee) for being the «I will
+   change it quickly and have something ready in an hour» base project (even if
+   I ended up redoing most of the hardware design). It was really nice to have a
+   solid base to learn and bootstrap the project.
+ * [Typematrix 2030](http://typematrix.com/2030/features.php): I own 2 of them
+   and really love them. But both are getting old and some keys are not working
+   correctly (this motivated the keyboard change).
  * [Steamvan](https://github.com/jmdaly/steamvan) for some KiCad design ideas;
- * [help-14](https://github.com/help-14/mechanical-keyboard) for making a nice list of existing keyboard;
- * [Masterzen](http://www.masterzen.fr/2020/05/03/designing-a-keyboard-part-1/) and many others for writing online tutorials for newbies like me.
+ * [Preonic](https://olkb.com/collections/preonic) as a model: ortholinear, good
+   balance between size/usability, simple.
 
 ## Usefull resources
  * [Mechanical Keyboard](https://github.com/help-14/mechanical-keyboard) is a list of DIY keyboards
- * [Awesome Mechanical Keyboard](https://github.com/BenRoe/awesome-mechanical-keyboard) is another [https://github.com/topics/awesome](«awesome») list
+ * [Awesome Mechanical Keyboard](https://github.com/BenRoe/awesome-mechanical-keyboard) is another [«awesome»](https://github.com/topics/awesome) list
+ * [help-14](https://github.com/help-14/mechanical-keyboard) for making a nice
+   list of existing keyboard;
+ * [Masterzen](http://www.masterzen.fr/2020/05/03/designing-a-keyboard-part-1/)
+   and many others for writing online tutorials for newbies like me.
+
+## Build log
+
+Disclaimer: I'm a software developper, this is my first real PCB design and my first try at SMD soldering: do not take anything here for granted :)
+
+The project started as a quick-hack of Keyseebee to make it simpler but ended up
+as a near full redesign. As every DIY project, the goal was to be quick and
+simple (spoiler: it was neither).
+
+Half of the parts have been soldered with a soldering iron (TS80P), the other
+half with hot air station. Clearly, with my [un]existing soldering skills, the
+hot air is a huge win. But I think I would have simply spent more time by only
+using the iron. Even the small sod-323 diodes without the `_handsoldering` pads
+(mistake) were not a real problem (tricky, but even I could do it).
+
+![Diodes soldering](images/closeup-diodes.jpg)
+
+The trickiest
+part is the USB connector if you don't have a hot air station: the plastic
+casing melts with the solder.
+
+![STm32 and Connector closeup](images/closeup-typec.jpg)
+
+* The LEDs are mostly optional, and the 6 used for the backlight are nearly
+  useless. I did not really study how to insert LEDs for a nice backlight and the
+  result is not really satisfactory.
+* I'll hopefully find time to use plexiglass plate to put below the PCB and
+  above the visible part. I've added holes for this but never really planed
+  anything really. If you really want something nice here, you may check this
+  before.
+
+
+## Layout
+
+As a typematrix user, I really like the middle column with `backspace/enter/del`
+so naturaly I've tried to do something similar. The [initial
+layout](http://www.keyboard-layout-editor.com/##@_pcb:true;&@_c=#cf94ff&sm=cherry&sb=gateron;&=F1%0A%0A%0A%0A%0A%0A%0A%0A%0A#%0A$&_c=#8f00ff;&=F2%0A%0A%0A%E2%80%94%0A%0A%0A%0A%0A%0A1%0A%22&=F3%0A%0A%0A%3C%0A%0A%0A%0A%0A%0A2%0A%C2%AB&=F4%0A%0A%0A%3E%0A%0A%0A%0A%0A%0A3%0A%C2%BB&=F5%0A%0A%0A%5B%0A%0A%0A%0A%0A%0A4%0A(&=F6%0A%0A%0A%5D%0A%0A%0A%0A%0A%0A5%0A)&=F7%0A%0A%0A%0A%0A%0A%0A%0A%0A6%0A/@&=F8%0A%0A%0A%0A%0A%0A%0A%0A%0A7%0A+&=F9%0A%0A%0A%0A%0A%0A%0A%0A%0A8%0A-&=F10%0A%0A%0A%0A%0A%0A%0A%0A%0A9%0A//&=F11%0A%0A%0A%0A%0A%0A%0A%0A%0A0%0A*&_c=#cf94ff;&=F12%0A%0A%0A%0A%0A%0A%0A%0A%0A%C2%B0%0A/=;&@_c=#4bfad0;&=PrtScr%0A%0A%0A%7C%0A%0A%0A%0A%0A%0AB&=VerNum%0A%0A%0A%0A%0A%0A%0A%0A%0A%C3%89&=%0A%0A%0A/&%0A%0A%0A%0A%0A%0AP&=%0A%0A%0A%C5%93%0A%0A%0A%0A%0A%0AO&_a:7;&=%C3%88&_c=#fcc0c0&a:4;&=Esc%0A%0A%0A%0A%0A%0A%0A%0A%0ATab&_c=#dbfff7;&=Ins%0A%0A%0A%0A%0A%0A%0A%0A%0A!%0A%5E&_c=#4bfad0;&=/&uArr/;%0A%0A%0A%0A%0A%0A%0A%0A%0AV&=/&dArr/;%0A%0A%0A%0A%0A%0A%0A%0A%0AD&=7%0A%0A%0A%0A%0A%0A%0A%0A%0AL&=8%0A%0A%0A%0A%0A%0A%0A%0A%0AJ&=9%0A%0A%0A%0A%0A%0A%0A%0A%0AZ;&@=%0A%0A%0A%C3%A6%0A%0A%0A%0A%0A%0AA&=%0A%0A%0A%C3%B9%0A%0A%0A%0A%0A%0AU&=%0A%0A%0A%22%0A%0A%0A%0A%0A%0AI&=%0A%0A%0A%E2%82%AC%0A%0A%0A%0A%0A%0AE&_c=#dbfff7&a:5;&=%0A,%0A%0A%0A%0A%0A/;&_c=#fcc0c0&a:7;&=%3Ci%20class/='mss%20mss-Unicode-BackSpace-DeleteLeft-Big-2'%3E%3C//i%3E&_c=#4bfad0&a:4;&=%3Ci%20class/='kb%20kb-Arrows-Top-2'%3E%3C//i%3E%0A%0A%0A%0A%0A%0A%0A%0A%0AC&=/&uarr/;%0A%0A%0A%0A%0A%0A%0A%0A%0AT&=%3Ci%20class/='kb%20kb-Arrows-Bottom-2'%3E%3C//i%3E%0A%0A%0A%0A%0A%0A%0A%0A%0AS&=4%0A%0A%0A%0A%0A%0A%0A%0A%0AR&=5%0A%0A%0A%0A%0A%0A%0A%0A%0AN&=6%0A%0A%0A%0A%0A%0A%0A%0A%0AM;&@=%0A%0A%0A%5C%0A%0A%0A%0A%0A%0A%C3%80&=%0A%0A%0A%7B%0A%0A%0A%0A%0A%0AY&=%0A%0A%0A%7D%0A%0A%0A%0A%0A%0AX&_c=#dbfff7;&=%0A%0A%0A%E2%80%A6%0A%0A%0A%0A%0A%0A/:%0A.&_c=#4bfad0;&=%0A%0A%0A~%0A%0A%0A%0A%0A%0AK&_c=#fcc0c0&a:7;&=/&crarr/;&_c=#dbfff7&a:4;&=/&larr/;%0A%0A%0A%0A%0A%0A%0A%0A%0A?%0A'&_c=#4bfad0;&=/&darr/;%0A%0A%0A%0A%0A%0A%0A%0A%0AQ&=/&rarr/;%0A%0A%0A%0A%0A%0A%0A%0A%0AG&=1%0A%0A%0A%0A%0A%0A%0A%0A%0AH&=2%0A%0A%0A%0A%0A%0A%0A%0A%0AF&=3%0A%0A%0A%0A%0A%0A%0A%0A%0A%C3%87;&@_c=#ff59d1&a:7;&=Ctrl&_c=#1500ff;&=Shift&_c=#8f00ff;&=Win&=/&uArr/;&=Alt&_c=#fcc0c0&a:4;&=%0A%0A%0A/_%0A%0A%0A%0A%0A%0Anbspc%0Aspc&_c=#8f00ff&a:7;&=Del&=AltGr&_c=#dbfff7&a:5;&=%0A%25%0A%0A%0A%0A%0A%60&_c=#4bfad0&a:4;&=0%0A%0A%0A%0A%0A%0A%0A%0A%0AW&_c=#1500ff&a:7;&=Shift&_c=#ff59d1;&=Ctrl) has only the `%` and `w` key at different locations:
+![Typematrix-like layout](images/layout.png)
+
+![Typematrix comparison](images/typematrix-comparison.jpg)
 
 ## Bill Of Materials
 
 |Item                                                                      |Package|Qty|Remarks                                |Price |
 |--------------------------------------------------------------------------|-------|--:|---------------------------------------|-----:|
-| PCB                                                                      |       | 3 | aisler                                |      |
+| PCB                                                                      |       | 3 | [aisler](https://aisler.net/p/BWUOMHHS) |  86.40€  |
 | 100 nF                                                                   | 0805  | 5 | magic match aisler                    | 0    |
-| PRTR5V0U2X,215                                                           | sot-143| 1 |                                      | 0.43 |
+| PRTR5V0U2X,215                                                           | sot-143| 1 |                                      | 0.43€ |
 | 4.7 uF                                                                   | 0805  | 2 |                                       | 0    |
 | 470 Ohm                                                                  | 0805  | 1 | magic match aisler                    | 0    |
-| TLV70233DBVR                                                             | sot-23| 1 | magic match aisler                    | 0.37 |
-| 74LVC1G34GW,125                                                          |       | 1 | magic match aisler                    | 0.28 |
-| 0805L050WR (500mA Polyfuse)                                              | 0805  | 1 | magic match aisler                    | 1.91 |
-| RS282G05A3SMRT (micro switch)                                            |       | 2 | magic match aisler                    | 1.26 |
+| TLV70233DBVR                                                             | sot-23| 1 | magic match aisler                    | 0.37€ |
+| 74LVC1G34GW,125                                                          |       | 1 | magic match aisler                    | 0.28€ |
+| 0805L050WR (500mA Polyfuse)                                              | 0805  | 1 | magic match aisler                    | 1.91€ |
+| RS282G05A3SMRT (micro switch)                                            |       | 2 | magic match aisler                    | 1.26€ |
 | 100nF                                                                    | 0805  | 2 | magic match aisler                    | 0 |
 | 5.1 kOhm                                                                 | 0805  | 3 | magic match aisler                    | 0 |
 | 0805L050WR (500mA Polyfuse)                                              | 0805  | 1 | magic match aisler                    | 0 |
 | 1N4148WS-7-F                                                             | sod-323 | 60|                                     |   |
-| WS2812B                                                                  |       | 10|                                       |   |
-| USB TypeC HRO Receptacle                                                 |       | 1 |                                       |   |
+| [WS2812B](https://www.aliexpress.com/item/4000750610574.html?spm=a2g0s.9042311.0.0.27424c4dS3DGkH)                                                                  |       | 10|                                       | 1€  |
+| [USB TypeC HRO Receptacle](https://www.aliexpress.com/item/33056042016.html?spm=a2g0s.9042311.0.0.1d8b4c4d8WcR7j)                                                 |       | 1 |                                       |   |
 | Gateron Switch                                                           |       | 60|                                       |   |
 | Keycaps                                                                  |       | 60|                                       |   |
 
diff --git a/images/above-with-back.jpg b/images/above-with-back.jpg
deleted file mode 100644
index 375286d..0000000
--- a/images/above-with-back.jpg
+++ /dev/null
diff --git a/images/closeup-diodes.jpg b/images/closeup-diodes.jpg
new file mode 100644
index 0000000..abe8743
--- /dev/null
+++ b/images/closeup-diodes.jpg
diff --git a/images/closeup-finish.jpg b/images/closeup-finish.jpg
new file mode 100644
index 0000000..c630f71
--- /dev/null
+++ b/images/closeup-finish.jpg
diff --git a/images/closeup-typec.jpg b/images/closeup-typec.jpg
new file mode 100644
index 0000000..37ee5ce
--- /dev/null
+++ b/images/closeup-typec.jpg
diff --git a/images/keyseebee.jpg b/images/keyseebee.jpg
deleted file mode 100644
index 13f8f06..0000000
--- a/images/keyseebee.jpg
+++ /dev/null
diff --git a/images/layout.png b/images/layout.png
new file mode 100644
index 0000000..ab6c2ac
--- /dev/null
+++ b/images/layout.png
diff --git a/images/pouetpouet.jpg b/images/pouetpouet.jpg
new file mode 100644
index 0000000..5efb68a
--- /dev/null
+++ b/images/pouetpouet.jpg
diff --git a/images/side-view.jpg b/images/side-view.jpg
deleted file mode 100644
index 7e84012..0000000
--- a/images/side-view.jpg
+++ /dev/null
diff --git a/images/typematrix-comparison.jpg b/images/typematrix-comparison.jpg
new file mode 100644
index 0000000..773b917
--- /dev/null
+++ b/images/typematrix-comparison.jpg