httpwg / httpbis-issues

1 stars 1 forks source link

Gen-Art review of draft-ietf-httpbis-p5-range-24 #521

Closed mnot closed 3 years ago

mnot commented 10 years ago

Document: draft-ietf-httpbis-p5-range-24 Reviewer: Kathleen Moriarty Review Date: November 18, 2013 IETF LC End Date: End of November IESG Telechat date: (if known)

Summary: The draft is ready with nits to resolve. The run-on sentences need to be corrected to make the draft easier to read. I called out a few examples, however, there are many more in the draft. I reviewed this a couple of weeks ago, before -25 was released and am working my way through all of the documents.

Major issues:

Minor issues:

Nits/editorial comments:

Please go through the draft in detail and break up run-on sentences into multiple sentences where possible.

Section 3.2: At end of second to last paragraph, remove parenthesis around full sentence.

Section 4.2: Please break first sentence into multiple. Section 4.3 - 4th paragraph really needs to be broken into multiple sentences.

Reported by julian.reschke@gmx.de, migrated from https://trac.ietf.org/trac/httpbis/ticket/521

mnot commented 10 years ago
mnot commented 10 years ago

@mnot changed type from design to editorial

mnot commented 10 years ago

Is is my opinion that the spec is ok the way it is.

mnot commented 10 years ago

fielding@gbiv.com commented:

From 2560:

(editorial) remove parentheses in 3.2 and make the point clearer; see #521