Subject: Re: [core] Adam Roach's No Objection on draft-ietf-core-multipart-ct-03: (with COMMENT)

From: Carsten Bormann <[email-masked]>
Date: Thu, 2 May 2019 14:49:44 +0200

On Apr 30, 2019, at 15:57, Thomas Fossati <[email-masked]> wrote:
> 
> Hi Adam, thanks for the comments.
> 
> On 30/04/2019, 07:31, "Adam Roach via Datatracker" <[email-masked]> wrote:
>    ----------------------------------------------------------------------
>    COMMENT:
>    ----------------------------------------------------------------------
> 
>    Thanks for the work everyone put in on this document.
> 
>    The "Usage Examples" section seems a bit odd, since it only describes the use of
>    this new content type for sending a response prior to the response body becoming
>    available. The introduction does not give the impression that this is the
>    primary use case -- it implies that this new format is primarily intended to
>    be used in a similar fashion as the traditional multipart/* media types.
>    Perhaps there should be some additional examples in section 3 that outline these
>    more common cases?
> 
> Yes, it is correct to say that this is not the primary use case, and yes, section 3.1 looks a bit lonesome...
> 
> I think we ended up like that as we felt like this was the only use case that needed some kind of "visual" -- all the others being pretty straightforward to grasp without any particular aid.
> 
> How about we add a bit of text at the top of sec 3 that articulates the above rationale?

Proposed change:

https://github.com/core-wg/multipart-ct/commit/b53b949b0d6cb3145b672627ad7ec3d3fb3ac8b2

This focuses the section 3 on this one usage example, which is shown because it might be non-obvious.

Grüße, Carsten