diff --git a/docs/docs/config/kscan.md b/docs/docs/config/kscan.md
index 787d5136..629a79f9 100644
--- a/docs/docs/config/kscan.md
+++ b/docs/docs/config/kscan.md
@@ -297,9 +297,7 @@ Any keyboard which is not a grid of 1 unit keys will likely have some unused pos
 
     kscan0: kscan {
         compatible = "zmk,kscan-gpio-matrix";
-        rows = <5>;
-        columns = <4>;
-        // define the matrix...
+        // define row-gpios with 5 elements and col-gpios with 4...
     };
 
     default_transform: matrix_transform {
@@ -359,9 +357,7 @@ Consider a keyboard with a [duplex matrix](https://wiki.ai03.com/books/pcb-desig
 
     kscan0: kscan {
         compatible = "zmk,kscan-gpio-matrix";
-        rows = <12>;
-        columns = <8>;
-        // define the matrix...
+        // define row-gpios with 12 elements and col-gpios with 8...
     };
 
     default_transform: matrix_transform {