Lars Eggert's No Objection on draft-ietf-httpbis-binary-message-05: (with COMMENT)

Lars Eggert has entered the following ballot position for
draft-ietf-httpbis-binary-message-05: No Objection

When responding, please keep the subject line intact and reply to all
email addresses included in the To and CC lines. (Feel free to cut this
introductory paragraph, however.)


Please refer to https://www.ietf.org/about/groups/iesg/statements/handling-ballot-positions/ 
for more information about how to handle DISCUSS and COMMENT positions.


The document, along with other ballot positions, can be found here:
https://datatracker.ietf.org/doc/draft-ietf-httpbis-binary-message/



----------------------------------------------------------------------
COMMENT:
----------------------------------------------------------------------

# GEN AD review of draft-ietf-httpbis-binary-message-05

CC @larseggert

Thanks to David Schinazi for the General Area Review Team (Gen-ART) review
(https://mailarchive.ietf.org/arch/msg/gen-art/HtcQ-wh6s1JXaRP8ECbfBGy8egc).

## Nits

All comments below are about very minor potential issues that you may choose to
address in some way - or ignore - as you see fit. Some were flagged by
automated tools (via https://github.com/larseggert/ietf-reviewtool), so there
will likely be some false positives. There is no need to let me know what you
did with these suggestions.

### Outdated references

Reference `[RFC2518]` to `RFC2518`, which was obsoleted by `RFC4918` (this may
be on purpose).

### Grammar/style

#### "Table of Contents", paragraph 1
```
TTP messages that can be conveyed outside of an HTTP protocol. This enables t
                                  ^^^^^^^^^^
```
This phrase is redundant. Consider using "outside".

#### Section 3.2, paragraph 9
```
gth messages can be truncated in a similar way as known-length messages; see
                              ^^^^^^^^^^^^^^^^
```
Consider replacing this phrase with the adverb "similarly" to avoid wordiness.

#### Section 5.2, paragraph 7
```
oundaries do not need to be retained and any chunk extensions cannot be conv
                                    ^^^^
```
Use a comma before "and" if it connects two independent clauses (unless they
are closely connected and short).

## Notes

This review is in the ["IETF Comments" Markdown format][ICMF], You can use the
[`ietf-comments` tool][ICT] to automatically convert this review into
individual GitHub issues. Review generated by the [`ietf-reviewtool`][IRT].

[ICMF]: https://github.com/mnot/ietf-comments/blob/main/format.md
[ICT]: https://github.com/mnot/ietf-comments
[IRT]: https://github.com/larseggert/ietf-reviewtool

Received on Thursday, 16 June 2022 12:15:25 UTC