diff --git a/README.md b/README.md
index 416ee86..048c2c3 100644
--- a/README.md
+++ b/README.md
@@ -177,7 +177,8 @@ Question            id (derived from the file's path - see routing
                     the visitor carries a chain; inferred from the
                     tree when unset), responsible {name, contact},
                     alternatives[]
-  Alternative       name, description, action, consequence[label],
+  Alternative       name, description, action, disabled (announced,
+                    not yet takeable), consequence[label],
                     encouragements[], images[] (1 = banner, 2+ = card deck),
                     record_as (bucket), self_transition {bucket, to, label},
                     features[]