* WGs marked with an * asterisk has had at least one new draft made available during the last 5 days

Ticket #542 (closed editorial: incorporated)

Opened 11 months ago

Last modified 11 months ago

improve introduction of list rule

Reported by: julian.reschke@gmx.de 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:
Origin:

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

comment:1 Changed 11 months ago by julian.reschke@gmx.de

From [2525]:

improve introduction of list operator (see #542)

comment:2 Changed 11 months ago by julian.reschke@gmx.de

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

comment:3 Changed 11 months ago by fielding@gbiv.com

From [2531]:

slightly rephrase [2525]; see #542

Note: See TracTickets for help on using tickets.