#542 closed editorial (incorporated)
improve introduction of list rule
Reported by: | julian.reschke@… | Owned by: | http://datatracker.ietf.org/doc/draft-ietf-httpbis-p1-messaging/ballot/ |
---|---|---|---|
Priority: | normal | Milestone: | 26 |
Component: | non-specific | Severity: | In IESG Evaluation |
Keywords: | Cc: |
Description
Ted Lemon
Discuss (2013-12-18)
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.
Change History (3)
comment:1 Changed 8 years ago by julian.reschke@…
comment:2 Changed 8 years ago by julian.reschke@…
- Resolution set to incorporated
- Status changed from new to closed
From [2525]:
improve introduction of list operator (see #542)