diff --git a/README.md b/README.md
index eba7cb9..b0351fa 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,10 @@
-# eightfold
+# Eightfold
 
 A collection of modules centered around the concept of generating and processing eight voices.
 
 <img src="https://github.com/scanner-darkly/eightfold-docs/blob/main/images/family.jpg?raw=true" alt="all module plates" width="736" height="380" />
 
-## orca's heart v2
+## Orca's Heart v2
 
 <img src="https://github.com/scanner-darkly/eightfold-docs/blob/main/images/orcas_heart_v2_panel.jpg?raw=true" alt="orca's heart v2 panel" width="450" height="380" />
 
@@ -14,7 +14,7 @@ An eight-voice algorithmic sequence generator, the new version of [orca's heart]
 This module generates sequences using an algorithm - instead of programming a sequence, you select the scale notes and control the algorithm parameters. You can use
 it to sequence up to 8 voices and produce 8 modulation CVs and gates that can be used to modulate Orca's Heart itself or other modules in your patch.
 
-## formation
+## Formation
 
 <img src="https://github.com/scanner-darkly/eightfold-docs/blob/main/images/formation_panel.jpg?raw=true" alt="formation panel" width="104" height="380" />
 
@@ -22,15 +22,15 @@ it to sequence up to 8 voices and produce 8 modulation CVs and gates that can be
 
 A mono to polyphonic voltage converter - take a single voltage and convert it into a swarm of eight voltages.
 
-## transgate
+## Transgate
 
 <img src="https://github.com/scanner-darkly/eightfold-docs/blob/main/images/transgate_panel.jpg?raw=true" alt="transgate panel" width="74" height="380" />
 
 [Full Manual](https://github.com/scanner-darkly/eightfold/wiki/Transgate)
 
-A polyphonic precision added - transpose a voltage when the corresponding gate is high. Transposition levels are set in semitones.
+A polyphonic gate controlled precision adder - transpose up to 8 voltages when the corresponding gate is high.
 
-## comparator
+## Comparator
 
 <img src="https://github.com/scanner-darkly/eightfold-docs/blob/main/images/comparator_panel.jpg?raw=true" alt="comparator panel" width="74" height="380" />
 
@@ -38,7 +38,7 @@ A polyphonic precision added - transpose a voltage when the corresponding gate i
 
 A polyphonic comparator - generate a gate when the input voltage reaches the corresponding threshold level.
 
-## lines
+## Lines
 
 <img src="https://github.com/scanner-darkly/eightfold-docs/blob/main/images/lines_panel.jpg?raw=true" alt="lines panel" width="29" height="380" />