docs: Add documentation for config options

docs/docs/behaviors/caps-word.md

@@ -5,7 +5,7 @@ sidebar_label: Caps Word
 
 ## Summary
 
-The caps word behavior behaves similar to a caps lock, but will automatically deactivate when one of the configured "break keycodes" is pressed, or if the caps word key is pressed again. For smaller keyboards, using [mod-taps](/docs/behaviors/mod-tap), this can help avoid repeated alternating holds when typing words in all caps.
+The caps word behavior behaves similar to a caps lock, but will automatically deactivate when any key not in a continue list is pressed, or if the caps word key is pressed again. For smaller keyboards using [mod-taps](/docs/behaviors/mod-tap), this can help avoid repeated alternating holds when typing words in all caps.
 
 The modifiers are applied only to to the alphabetic (`A` to `Z`) keycodes, to avoid automatically appliying them to numeric values, etc.
 

docs/docs/config/backlight.md

@@ -0,0 +1,40 @@
+---
+title: Backlight Configuration
+sidebar_label: Backlight
+---
+
+See the [backlight feature page](../features/backlight.md) for more details, including instructions for adding backlight support to a board.
+
+See [Configuration Overview](index.md) for instructions on how to change these settings.
+
+## Kconfig
+
+Definition file: [zmk/app/Kconfig](https://github.com/zmkfirmware/zmk/blob/main/app/Kconfig)
+
+| Option                               | Type | Description                                           | Default |
+| ------------------------------------ | ---- | ----------------------------------------------------- | ------- |
+| `CONFIG_ZMK_BACKLIGHT`               | bool | Enables LED backlight                                 | n       |
+| `CONFIG_ZMK_BACKLIGHT_BRT_STEP`      | int  | Brightness step in percent                            | 20      |
+| `CONFIG_ZMK_BACKLIGHT_BRT_START`     | int  | Default brightness in percent                         | 40      |
+| `CONFIG_ZMK_BACKLIGHT_ON_START`      | bool | Default backlight state                               | y       |
+| `CONFIG_ZMK_BACKLIGHT_AUTO_OFF_IDLE` | bool | Turn off backlight when keyboard goes into idle state | n       |
+| `CONFIG_ZMK_BACKLIGHT_AUTO_OFF_USB`  | bool | Turn off backlight when USB is disconnected           | n       |
+
+:::note
+The `*_START` settings only determine the initial backlight state. Any changes you make with the [backlight behavior](../behaviors/backlight.md) are saved to flash after a one minute delay and will be used after that.
+:::
+
+## Devicetree
+
+Applies to: [`/chosen` node](https://docs.zephyrproject.org/latest/build/dts/intro.html#aliases-and-chosen-nodes)
+
+| Property        | Type | Description                                  |
+| --------------- | ---- | -------------------------------------------- |
+| `zmk,backlight` | path | The node for the backlight LED driver to use |
+
+See the Zephyr devicetree bindings for LED drivers:
+
+- [gpio-leds](https://docs.zephyrproject.org/latest/build/dts/api/bindings/gpio/gpio-leds.html)
+- [pwm-leds](https://docs.zephyrproject.org/latest/build/dts/api/bindings/led/pwm-leds.html)
+
+See the [backlight feature page](../features/backlight.md) for examples of the properties that must be set to enable backlighting.

docs/docs/config/battery.md

@@ -0,0 +1,40 @@
+---
+title: Battery Level
+sidebar_label: Battery Level
+---
+
+See the [battery level feature page](../features/battery.md) for more details on configuring a battery sensor.
+
+See [Configuration Overview](index.md) for instructions on how to change these settings.
+
+### Devicetree
+
+Applies to: [`/chosen` node](https://docs.zephyrproject.org/latest/guides/dts/intro.html#aliases-and-chosen-nodes)
+
+| Property      | Type | Description                                   |
+| ------------- | ---- | --------------------------------------------- |
+| `zmk,battery` | path | The node for the battery sensor driver to use |
+
+## Battery Voltage Divider Sensor
+
+Driver for reading the voltage of a battery using an ADC connected to a voltage divider.
+
+### Devicetree
+
+Applies to: `compatible = "zmk,battery-voltage-divider"`
+
+See [Zephyr's voltage divider documentation](https://docs.zephyrproject.org/latest/build/dts/api/bindings/adc/voltage-divider.html).
+
+## nRF VDDH Battery Sensor
+
+Driver for reading the voltage of a battery using a Nordic nRF52's VDDH pin. This driver has no configuration except for the required `label` property.
+
+### Devicetree
+
+Applies to: `compatible = "zmk,battery-nrf-vddh"`
+
+Definition file: [zmk/app/drivers/zephyr/dts/bindings/sensor/zmk,battery-nrf-vddh.yaml](https://github.com/zmkfirmware/zmk/blob/main/app/drivers/zephyr/dts/bindings/sensor/zmk%2Cbattery-nrf-vddh.yaml)
+
+| Property | Type   | Description               |
+| -------- | ------ | ------------------------- |
+| `label`  | string | Unique label for the node |

docs/docs/config/behaviors.md

@@ -0,0 +1,208 @@
+---
+title: Behavior Configuration
+sidebar_label: Behaviors
+---
+
+Some behaviors have properties to adjust how they behave. These can also be used as templates to create custom behaviors when none of the built-in behaviors do what you want.
+
+See [Configuration Overview](index.md) for instructions on how to change these settings.
+
+See the [zmk/app/dts/behaviors/](https://github.com/zmkfirmware/zmk/tree/main/app/dts/behaviors) folder for all default behaviors.
+
+## Caps Word
+
+Creates a custom behavior that behaves similar to a caps lock but deactivates when any key not in a continue list is pressed.
+
+See the [caps word behavior](../behaviors/caps-word.md) documentation for more details and examples.
+
+### Devicetree
+
+Definition file: [zmk/app/dts/bindings/behaviors/zmk,behavior-caps-word.yaml](https://github.com/zmkfirmware/zmk/blob/main/app/dts/bindings/behaviors/zmk%2Cbehavior-caps-word.yaml)
+
+Applies to: `compatible = "zmk,behavior-caps-word"`
+
+| Property         | Type   | Description                                                        | Default        |
+| ---------------- | ------ | ------------------------------------------------------------------ | -------------- |
+| `label`          | string | Unique label for the node                                          |                |
+| `#binding-cells` | int    | Must be `<0>`                                                      |                |
+| `continue-list`  | array  | List of [key codes](/docs/codes) which do not deactivate caps lock | `<UNDERSCORE>` |
+| `mods`           | int    | A bit field of modifiers to apply                                  | `<MOD_LSFT>`   |
+
+`continue-list` is treated as if it always includes alphanumeric characters (A-Z, 0-9).
+
+See [dt-bindings/zmk/modifiers.h](https://github.com/zmkfirmware/zmk/blob/main/app/include/dt-bindings/zmk/modifiers.h) for a list of modifiers.
+
+You can use the following nodes to tweak the default behaviors:
+
+| Node         | Behavior                               |
+| ------------ | -------------------------------------- |
+| `&caps_word` | [Caps Word](../behaviors/caps-word.md) |
+
+## Hold-Tap
+
+Creates a custom behavior that triggers one behavior when a key is held or a different one when the key is tapped.
+
+See the [hold-tap behavior documentation](../behaviors/hold-tap.md) for more details and examples.
+
+### Devicetree
+
+Definition file: [zmk/app/dts/bindings/behaviors/zmk,behavior-hold-tap.yaml](https://github.com/zmkfirmware/zmk/blob/main/app/dts/bindings/behaviors/zmk%2Cbehavior-hold-tap.yaml)
+
+Applies to: `compatible = "zmk,behavior-hold-tap"`
+
+| Property                     | Type          | Description                                                                               | Default            |
+| ---------------------------- | ------------- | ----------------------------------------------------------------------------------------- | ------------------ |
+| `label`                      | string        | Unique label for the node                                                                 |                    |
+| `#binding-cells`             | int           | Must be `<2>`                                                                             |                    |
+| `bindings`                   | phandle array | A list of two behaviors (without parameters): one for hold and one for tap                |                    |
+| `flavor`                     | string        | Adjusts how the behavior chooses between hold and tap                                     | `"hold-preferred"` |
+| `tapping-term-ms`            | int           | How long in milliseconds the key must be held to trigger a hold                           |                    |
+| `quick-tap-ms`               | int           | Tap twice within this period (in milliseconds) to trigger a tap, even when held           | -1 (disabled)      |
+| `global-quick-tap`           | bool          | If enabled, `quick-tap-ms` also applies when tapping another key and then this one.       | false              |
+| `retro-tap`                  | bool          | Triggers the tap behavior on release if no other key was pressed during a hold            | false              |
+| `hold-trigger-key-positions` | array         | If set, pressing the hold-tap and then any key position _not_ in the list triggers a tap. |                    |
+
+The `flavor` property may be one of:
+
+- `"hold-preferred"`
+- `"balanced"`
+- `"tap-preferred"`
+- `"tap-unless-interrupted"`
+
+See the [hold-tap behavior documentation](../behaviors/hold-tap.md) for an explanation of each flavor.
+
+`hold-trigger-key-positions` is an array of zero-based key position indices.
+
+You can use the following nodes to tweak the default behaviors:
+
+| Node  | Behavior                                      |
+| ----- | --------------------------------------------- |
+| `&lt` | [Layer-tap](../behaviors/layers.md#layer-tap) |
+| `&mt` | [Mod-tap](../behaviors/mod-tap.md)            |
+
+## Key Repeat
+
+Creates a custom behavior that repeats the whatever key code was last sent.
+
+See the [key repeat behavior](../behaviors/key-repeat.md) documentation for more details and examples.
+
+### Devicetree
+
+Definition file: [zmk/app/dts/bindings/behaviors/zmk,behavior-key-repeat.yaml](https://github.com/zmkfirmware/zmk/blob/main/app/dts/bindings/behaviors/zmk%2Cbehavior-key-repeat.yaml)
+
+Applies to: `compatible = "zmk,behavior-key-repeat"`
+
+| Property         | Type   | Description                      | Default           |
+| ---------------- | ------ | -------------------------------- | ----------------- |
+| `label`          | string | Unique label for the node        |                   |
+| `#binding-cells` | int    | Must be `<0>`                    |                   |
+| `usage-pages`    | array  | List of HID usage pages to track | `<HID_USAGE_KEY>` |
+
+For the `usage-pages` property, use the `HID_USAGE_*` defines from [dt-bindings/zmk/hid_usage_pages.h](https://github.com/zmkfirmware/zmk/blob/main/app/include/dt-bindings/zmk/hid_usage_pages.h).
+
+You can use the following nodes to tweak the default behaviors:
+
+| Node          | Behavior                                 |
+| ------------- | ---------------------------------------- |
+| `&key_repeat` | [Key repeat](../behaviors/key-repeat.md) |
+
+## Macro
+
+Creates a custom behavior which triggers a sequence of other behaviors.
+
+See the [macro behavior](../behaviors/macros.md) documentation for more details and examples.
+
+### Devicetree
+
+Definition file: [zmk/app/dts/bindings/behaviors/zmk,behavior-macro.yaml](https://github.com/zmkfirmware/zmk/blob/main/app/dts/bindings/behaviors/zmk%2Cbehavior-macro.yaml)
+
+Applies to: `compatible = "zmk,behavior-macro"`
+
+| Property         | Type          | Description                                                                                           | Default |
+| ---------------- | ------------- | ----------------------------------------------------------------------------------------------------- | ------- |
+| `label`          | string        | Unique label for the node                                                                             |         |
+| `#binding-cells` | int           | Must be `<0>`                                                                                         |         |
+| `bindings`       | phandle array | List of behaviors to trigger                                                                          |         |
+| `wait-ms`        | int           | The default time to wait (in milliseconds) before triggering the next behavior.                       | 100     |
+| `tap-ms`         | int           | The default time to wait (in milliseconds) between the press and release events of a tapped behavior. | 100     |
+
+The following macro-specific behaviors can be added at any point in the `bindings` list to change how the macro triggers subsequent behaviors.
+
+| Behavior                   | Description                                                                                           |
+| -------------------------- | ----------------------------------------------------------------------------------------------------- |
+| `&macro_tap`               | Switches to tap mode                                                                                  |
+| `&macro_press`             | Switches to press mode                                                                                |
+| `&macro_release`           | Switches to release mode                                                                              |
+| `&macro_pause_for_release` | Pauses the macro until the macro key itself is released                                               |
+| `&macro_wait_time TIME`    | Changes the time to wait (in milliseconds) before triggering the next behavior.                       |
+| `&macro_tap_time TIME`     | Changes the time to wait (in milliseconds) between the press and release events of a tapped behavior. |
+
+## Mod-Morph
+
+Creates a custom behavior that triggers one of two behaviors depending on whether certain modifiers are held.
+
+### Devicetree
+
+Definition file: [zmk/app/dts/bindings/behaviors/zmk,behavior-mod-morph.yaml](https://github.com/zmkfirmware/zmk/blob/main/app/dts/bindings/behaviors/zmk%2Cbehavior-mod-morph.yaml)
+
+Applies to: `compatible = "zmk,behavior-mod-morph"`
+
+| Property         | Type          | Description                                                                       |
+| ---------------- | ------------- | --------------------------------------------------------------------------------- |
+| `label`          | string        | Unique label for the node                                                         |
+| `#binding-cells` | int           | Must be `<0>`                                                                     |
+| `bindings`       | phandle array | A list of two behaviors: one for normal press and one for mod morphed press       |
+| `mods`           | int           | A bit field of modifiers. The morph behavior is used if any of these are pressed. |
+
+See [dt-bindings/zmk/modifiers.h](https://github.com/zmkfirmware/zmk/blob/main/app/include/dt-bindings/zmk/modifiers.h) for a list of modifiers.
+
+You can use the following nodes to tweak the default behaviors:
+
+| Node     | Behavior                                  |
+| -------- | ----------------------------------------- |
+| `&gresc` | [Grave escape](../behaviors/mod-morph.md) |
+
+## Sticky Key
+
+Creates a custom behavior that triggers a behavior and keeps it pressed it until another key is pressed and released.
+
+See the [sticky key behavior](../behaviors/sticky-key.md) and [sticky layer behavior](../behaviors/sticky-layer.md) documentation for more details and examples.
+
+### Devicetree
+
+Definition file: [zmk/app/dts/bindings/behaviors/zmk,behavior-sticky-key.yaml](https://github.com/zmkfirmware/zmk/blob/main/app/dts/bindings/behaviors/zmk%2Cbehavior-sticky-key.yaml)
+
+Applies to: `compatible = "zmk,behavior-sticky-key"`
+
+| Property           | Type          | Description                                                              | Default |
+| ------------------ | ------------- | ------------------------------------------------------------------------ | ------- |
+| `label`            | string        | Unique label for the node                                                |         |
+| `#binding-cells`   | int           | Must match the number of parameters the `bindings` behavior uses         |         |
+| `bindings`         | phandle array | A behavior (without parameters) to trigger                               |         |
+| `release-after-ms` | int           | Releases the key after this many milliseconds if no other key is pressed | 1000    |
+| `quick-release`    | bool          | Release the sticky key on the next key press instead of release          | false   |
+| `ignore-modifiers` | bool          | If enabled, pressing a modifier key does not cancel the sticky key       | true    |
+
+You can use the following nodes to tweak the default behaviors:
+
+| Node  | Behavior                                     |
+| ----- | -------------------------------------------- |
+| `&sk` | [Sticky key](../behaviors/sticky-key.md)     |
+| `&sl` | [Sticky layer](../behaviors/sticky-layer.md) |
+
+## Tap Dance
+
+Creates a custom behavior that triggers a different behavior corresponding to the number of times the key is tapped.
+
+### Devicetree
+
+Definition file: [zmk/app/dts/bindings/behaviors/zmk,behavior-tap-dance.yaml](https://github.com/zmkfirmware/zmk/blob/main/app/dts/bindings/behaviors/zmk%2Cbehavior-tap-dance.yaml)
+
+Applies to: `compatible = "zmk,behavior-tap-dance"`
+
+| Property          | Type          | Description                                                                                  | Default |
+| ----------------- | ------------- | -------------------------------------------------------------------------------------------- | ------- |
+| `label`           | string        | Unique label for the node                                                                    |         |
+| `#binding-cells`  | int           | Must be `<0>`                                                                                |         |
+| `bindings`        | phandle array | A list of behaviors from which to select                                                     |         |
+| `tapping-term-ms` | int           | The maximum time (in milliseconds) between taps before an item from `bindings` is triggered. | 200     |