move some docs to root

README.md

@@ -101,6 +101,57 @@ using `rustup` and the latter using `nix-shell`. From there, use the commands in
 just arranger
 ```
 
+## contents
+
+This crate provides several musical utilities.
+
+### `tek_sequencer`
+
+A single-track, multi-pattern MIDI sequencer with properly tempo-synced pattern switch.
+
+### `tek_groovebox`
+
+A single-track, multi-pattern MIDI sequencer, attached to a sampler or plugin
+(see `tek_plugin`).
+
+### `tek_arranger`
+
+A multi-track, multi-pattern MIDI sequencer translating the familiar clip launching workflow
+into the TUI medium.
+
+### `tek_transport`
+
+Standalone JACK transport controller.
+
+* Todo: bpm: shift  +/- 0.001
+* Todo: quant/sync: shift = next/prev value of same type (normal, triplet, dotted)
+    * Or: use shift to switch between inc/dec top/bottom value?
+* Todo: focus play button
+* Todo: focus time position
+* Todo: edit numeric values
+* Todo: jump to time/bbt markers
+* Todo: count xruns
+
+## `tek_sampler`
+
+TODO: Standalone MIDI-controlled sampler.
+
+## `tek_mixer`
+
+TODO: Mixer.
+
+- Meters: propagate clipping:
+  - If one stage clips, all stages after it are marked red
+  - If one track clips, all tracks that feed from it are marked red?
+
+## `tek_track`
+
+TODO: Channel strip.
+
+## `tek_plugin`
+
+TODO: Plugin host.
+
 ## usage
 
 > [!WARNING]