feat(docs): Basic mod-tap behavior docs.

2 files changed, 30 insertions, 0 deletions

diff --git a/docs/docs/behavior/mod-tap.md b/docs/docs/behavior/mod-tap.md
new file mode 100644
index 0000000..cae667e
--- /dev/null
+++ b/docs/docs/behavior/mod-tap.md
@@ -0,0 +1,29 @@
+---
+title: Mod-Tap
+---
+
+## Summary
+
+The Mod-Tap behavior allows varying the effect of pressing and releasing a key position depending
+on whether it is used with other simultaneous key presses at the same time.
+
+If pressed and released independently, the Mod-Tap behavior will send the press and release events
+for the configure keycode. If pressed and held while another key is pressed and released, then
+the configured modifiers will be applied to that _other_ key press, and no press will be generated
+on the release of the Mod-Tap key.
+
+## Mod-Tap
+
+The Mod-Tap behavior either acts as a held modifier, or as a tapped keycode.
+
+### Behavior Binding
+
+- Reference: `&mt`
+- Parameter #1: The modifiers to be used when activating as a modifier, e.g. `MOD_LSFT`
+- Parameter #2: The keycode to sent when used as a tap, e.g. `A`, `B`.
+
+Example:
+
+```
+&mt MOD_LSFT A
+```
diff --git a/docs/sidebars.js b/docs/sidebars.js
index 90bdfa2..be02a65 100644
--- a/docs/sidebars.js
+++ b/docs/sidebars.js
@@ -11,6 +11,7 @@ module.exports = {
       "behavior/key-press",
       "behavior/layers",
       "behavior/misc",
+      "behavior/mod-tap",
       "behavior/lighting",
     ],
     Development: [