Ticket #542 (closed editorial: incorporated)
improve introduction of list rule
|Reported by:||email@example.com||Owned by:||http://datatracker.ietf.org/doc/draft-ietf-httpbis-p1-messaging/ballot/|
|Component:||non-specific||Severity:||In IESG Evaluation|
The list rule exception mentioned in section 1.2 confused the hell out of me until I got to section 7. Why is section 7 not a subsection of section 2? I assume the answer is "because it's long, and would suck the wind out of the document if it were at the beginning," which is fine, but if so, it would be nice if the text in 1.2 did a *bit* more foreshadowing. E.g.:
This specification uses the Augmented Backus-Naur Form (ABNF) notation of [RFC5234] with an extension defined in Section 7 that adds compact support for comma-separated lists with the addition of a # token to the usual ABNF token set, similar to the * token. Appendix B shows the collected ABNF with the list rule expanded.