User-friendly documentation therefore has to include an index that associates a grammar rule (or macro) with the documentation sections that comment on this rule.
besides referencing from the documentation to the grammar (by copying), the documentation must also support referencing (indexing) from various parts of the grammar to the relevant parts of the documentation.