Example Media Types for Use in Documentation
draft-taylor-types-example-05

[Ballot comment]
I understand that there has been a bunch of discussion in a couple WGs about whether it's OK for documents to use unregistered example MIME types, and that has prompted this proposal.  While I think that the original document critique is a stupid concern and over-literalist, I'm OK with the example types being registered if it stops the time-wasting discussions.

[Ballot discuss]
Holding a discuss for IANA:

The document also requests registration of "the example media type".
Should this be added to the listing of media types at the following locations or does IANA
not need to add anything?

http://www.iana.org/assignments/media-types/index.html
http://www.iana.org/assignments/media-types-parameters

IANA Last Call Comments:

Upon approval of this document the IANA will register the following media sub-types in the
appropriate locations:
text/example in:
http://www.iana.org/assignments/media-types/text/

image/example in:
http://www.iana.org/assignments/media-types/image/

audio/example in:
http://www.iana.org/assignments/media-types/audio/

video/example in:
http://www.iana.org/assignments/media-types/video/

application/example in:
http://www.iana.org/assignments/media-types/application/

multipart/example in:
http://www.iana.org/assignments/media-types/multipart/

The document also requests registration of "the example media type".
Should this be added to the listing of media types at the following locations or does IANA
not need to add anything?

http://www.iana.org/assignments/media-types/index.html
http://www.iana.org/assignments/media-types-parameters

IANA Last Call Comments:

Upon approval of this document the IANA will register the following media sub-types in the
appropriate locations:
text/example in:
http://www.iana.org/assignments/media-types/text/

image/example in:
http://www.iana.org/assignments/media-types/image/

audio/example in:
http://www.iana.org/assignments/media-types/audio/

video/example in:
http://www.iana.org/assignments/media-types/video/

application/example in:
http://www.iana.org/assignments/media-types/application/

multipart/example in:
http://www.iana.org/assignments/media-types/multipart/

The document also requests registration of "the example media type".
Should this be added to the listing of media types at the following locations or does IANA
not need to add anything?

http://www.iana.org/assignments/media-types/index.html
http://www.iana.org/assignments/media-types-parameters

[Ballot comment]
It is not clear to me why this document is on track for Proposed Standard. I can hardly see how it can be checked vs. criteria of progressing on standards track. Section 5 says 'The 'example' media type and subtypes are defined for use in documentation only.'. RFC4288 - a BCP itself - says in Section 3.1 'In the case of registration for the IETF itself, the registration proposal MUST be published as an RFC' without making a statement about the need for a standards track RFC. Maybe there are some other considerations of consistency, or some precedents that escape me.

[Ballot discuss]
The document says:

  Subtype name: any subtype may be used with the 'example' type.
  However, subtypes of 'example' MUST NOT be registered.

I think this is not quite clear enough.  I first read it as preventing registration
of things like type/example; that wouldn't make sense, obviously, since this
document registers several of those.  The intent is to say that "IANA MUST NOT
register subtypes for the 'example" type. "

It is not clear to me why this document covers some top-level types and not
all (e.g. model/example or message/example).  I would like to discuss whether
this should be fully generalized, or whether those should be added only on
demonstrated need.