How about changing the first paragraph of Section 3.2 to the following: "The server returns a variable-length string that is the generated preview for that message. This string is intended to be viewed by the user as a contextual preview of the entire message, and is not intended to be interpreted in any way by the client software."
Slightly altered Barry's wording - "user" is already defined in Section 2 as the human user, so to be consistent I think we should use "user" instead of "end-user". michael > On 09/15/2020 3:26 PM Barry Leiba <barryle...@computer.org> wrote: > > > Meral, thanks for the review. The document does say in the first > sentence of the Introduction that the preview is for the end user. I agree > that it would be useful to emphasize that, though, and I think the right > place to do it is by adding to the first paragraph of Section 3.2 something > like the following: “The preview string is meant to help the end-user, and is > not intended to be interpreted in any way by the client software.” > > Barry > > On Tue, Sep 15, 2020 at 4:52 PM Meral Shirazipour via Datatracker > <nore...@ietf.org mailto:nore...@ietf.org > wrote: > > > > Reviewer: Meral Shirazipour > > > > Review result: Ready with Nits > > > > > > > > I am the assigned Gen-ART reviewer for this draft. The General Area > > > > Review Team (Gen-ART) reviews all IETF documents being processed > > > > by the IESG for the IETF Chair. Please treat these comments just > > > > like any other last call comments. > > > > > > > > For more information, please see the FAQ at > > > > > > > > <https://trac.ietf.org/trac/gen/wiki/GenArtfaq>. > > > > > > > > Document: draft-ietf-extra-imap-fetch-preview-09 > > > > Reviewer: Meral Shirazipour > > > > Review Date: 2020-09-15 > > > > IETF LC End Date: 2020-09-14 > > > > IESG Telechat date: Not scheduled for a telechat > > > > > > > > Summary: This draft is ready to be published as Standards Track RFC > > but I have > > > > some comments. > > > > > > > > Major issues: > > > > > > > > Minor issues: > > > > > > > > Nits/editorial comments: In Section 4.2, it would have been good to > > give some > > > > example and advice on when the client uses the preview to take some > > action. Is > > > > this to be avoided? (Was not very clear to me). > > > > > > > > Best Regards, > > > > Meral Shirazipour > > > > http://www.ericsson.com > > > > > > > > > > > > > > > > > > > > >
_______________________________________________ Gen-art mailing list Gen-art@ietf.org https://www.ietf.org/mailman/listinfo/gen-art
