fix(docs): Apply suggestions from #722 reviews

This commit is contained in:
Cem Aksoylar
2022-07-03 14:05:55 -07:00
committed by Dom H
parent ae78aa247a
commit 851c37e14f
4 changed files with 23 additions and 16 deletions

View File

@@ -157,6 +157,8 @@ this might look something like:
};
```
See the [Keyboard Scan configuration documentation](../config/kscan.md) for details on configuring the KSCAN driver.
</TabItem>
<TabItem value="split">
@@ -260,6 +262,8 @@ This is exemplified with the iris .overlay files.
```
See the [Keyboard Scan configuration documentation](../config/kscan.md) for details on configuring the KSCAN driver.
### .conf files (Split Shields)
While unibody boards only have one .conf file that applies configuration characteristics to the entire keyboard,
@@ -341,6 +345,8 @@ Some important things to note:
- `RC(row, column)` is placed sequentially to define what row and column values that position corresponds to.
- If you have a keyboard with options for `2u` keys in certain positions, or break away portions, it is a good idea to set the chosen `zmk,matrix_transform` to the default arrangement, and include _other_ possible matrix transform nodes in the devicetree that users can select in their user config by overriding the chosen node.
See the [matrix transform section](../config/kscan.md#matrix-transform) in the Keyboard Scan configuration documentation for details and more examples of matrix transforms.
## Default Keymap
Each keyboard should provide an OOTB default keymap to be used when building the firmware, which can be overridden and customized by user configs. For "shield keyboards", this should be placed in the `app/boards/shields/<shield_name>/<shield_name>.keymap` file. The keymap is configured as an additional devicetree overlay that includes the following: