dqz11n1g: Documentation improvement. (#19230)

Co-authored-by: David <dvdkhlng@posteo.de>

2 files changed, 12 insertions, 10 deletions

diff --git a/keyboards/handwired/dqz11n1g/matrix.c b/keyboards/handwired/dqz11n1g/matrix.c
index f9f3f2b68f..d93dd853b6 100644
--- a/keyboards/handwired/dqz11n1g/matrix.c
+++ b/keyboards/handwired/dqz11n1g/matrix.c
@@ -38,7 +38,7 @@ void matrix_init_custom(void) {
 
     /* columns read via shift-register on SPI lines */
 
-    /* Enable SPI, Master, set clock rate fck/2.  First bit already at Qh
+    /* Enable SPI, Master, set clock rate fck/16.  First bit already at Qh
      * output before clock edge (CPHA=0).  SN74HC165 shift register shifts
      * on low-to-high transition (CPOL=1).  Receive the LSB first (DORD=1).
      */
diff --git a/keyboards/handwired/dqz11n1g/readme.md b/keyboards/handwired/dqz11n1g/readme.md
index 0e3a57873d..9fbebb5178 100644
--- a/keyboards/handwired/dqz11n1g/readme.md
+++ b/keyboards/handwired/dqz11n1g/readme.md
@@ -2,24 +2,26 @@
 
 ![DQz11N1G](https://u.cubeupload.com/ddklg/OPBN5q.jpg)
 
-Firmware for a DIY controller replacement for one of the ortholinear contoured
-keyboards manufactured by [PCD Maltron Ltd](https://www.maltron.com)
+Using QMK with one of the ortholinear contoured keyboards manufactured by [PCD
+Maltron Ltd](https://www.maltron.com) by modding it with a DIY replacement
+controller.
 
 This work here in no way officially associated with PCD Maltron Ltd and comes
-with NO WARRANTY.  Modifying your Maltron keyboard as described below will
-certainly void your warranty and may cause damage to your keyboard.  Proceed
-at your own risk!
+with ABSOLUTELY NO WARRANTY, to the extent permitted by applicable law.
+Modifying your Maltron keyboard as described below will certainly void your
+warranty and may e.g. cause damage to your keyboard.  Proceed at your own risk!
 
 * maintainer: [David Kuehling](https://github.com/dvdkhlng/qmk_firmware_dqz11n1g)
 * Hardware Supported: Maltron DQz11N1G with a replacement controller board
-  assembled as described below.  The work here is based on a german version
+  assembled as described below.  The work here is based on a German version
   of the keyboard: DQz11N1G-DE.  I assume, but don't know for sure, that
   minor or no changes at all are required to make this work on different
   language versions of the keyboard.
 * Hardware Availability:
   * [PCD Maltron Ltd](https://www.maltron.com), for the original keyboard
   * 1x [Arduino Pro Micro](https://www.sparkfun.com/products/12640)
-  * 3x [SN74HC165](https://www.ti.com/product/SN74HC165)
+  * 3x shift register [SN74HC165](https://www.ti.com/product/SN74HC165)
+  * 3x ceramic blocking capacitors (100 nF) one for each shift register
   * 1x DIL connector 2 rows a 17 pins.
   * 19x pull-down resistors (10k Ohm),
   * 4 LED current limiting resistors (not sure about the correct resistance,
@@ -31,7 +33,7 @@ Make example for this keyboard (after setting up your build environment):
 
 ## In Detail
 
-[PCD Maltron Ltd](https://www.maltron.com) manufacturs ergonomic keyboards
+[PCD Maltron Ltd](https://www.maltron.com) manufactures ergonomic keyboards
 that appear to be hand-wired internally.  For the Maltron DQz11N1G-DE
 keyboard that I happen to own, the keyboard matrix is wired to a 34-pin DIL
 connector.  This makes it rather easy to replace the proprietary
@@ -57,7 +59,7 @@ board which is still easy to source.
 Unfortunately pin-count of the DQz11N1G-DE's keyboard matrix is way beyond
 the Pro Micro's available I/O pin count.  I'm using three 8-bit
 shift-registers ([SN74HC165](https://www.ti.com/product/SN74HC165) ) to
-connect the 19 colums of the keyboard matrix for readout.  Due to diode
+connect the 19 columns of the keyboard matrix for readout.  Due to diode
 direction in DQz11N1G-DE we also need 19 pull-down resistors one for each of
 the utilized shift-register inputs.