Opened 3 years ago

Closed 3 years ago

Last modified 3 years ago

#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 3 years ago by julian.reschke@…

From [2525]:

improve introduction of list operator (see #542)

comment:2 Changed 3 years ago by julian.reschke@…

  • Resolution set to incorporated
  • Status changed from new to closed

comment:3 Changed 3 years ago by fielding@…

From [2531]:

slightly rephrase [2525]; see #542

Note: See TracTickets for help on using tickets.