Skip to main content

The text/markdown Media Type
draft-ietf-appsawg-text-markdown-12

Revision differences

Document history

Date Rev. By Action
2016-03-09
12 (System) RFC Editor state changed to AUTH48-DONE from AUTH48
2016-01-28
12 (System) RFC Editor state changed to AUTH48 from RFC-EDITOR
2016-01-27
12 (System) RFC Editor state changed to RFC-EDITOR from REF
2016-01-11
12 (System) RFC Editor state changed to REF from EDIT
2015-10-26
12 (System) IANA Action state changed to RFC-Ed-Ack from Waiting on RFC Editor
2015-10-25
12 (System) IANA Action state changed to Waiting on RFC Editor from Waiting on Authors
2015-10-23
12 (System) IANA Action state changed to Waiting on Authors from In Progress
2015-10-22
12 (System) IANA Action state changed to In Progress from Waiting on Authors
2015-10-22
12 (System) IANA Action state changed to Waiting on Authors
2015-10-19
12 (System) RFC Editor state changed to EDIT
2015-10-19
12 (System) RFC Editor state changed to EDIT
2015-10-19
12 (System) IESG state changed to RFC Ed Queue from Approved-announcement sent
2015-10-19
12 (System) Announcement was received by RFC Editor
2015-10-19
12 Amy Vezza IESG state changed to Approved-announcement sent from Approved-announcement to be sent
2015-10-19
12 Amy Vezza IESG has approved the document
2015-10-19
12 Amy Vezza Closed "Approve" ballot
2015-10-19
12 Amy Vezza Ballot approval text was generated
2015-10-18
12 Barry Leiba IESG state changed to Approved-announcement to be sent from IESG Evaluation::AD Followup
2015-10-18
12 Barry Leiba Ballot writeup was changed
2015-10-17
12 Sean Leonard New version available: draft-ietf-appsawg-text-markdown-12.txt
2015-10-15
11 Suresh Krishnan Request for Last Call review by GENART Completed: Ready with Issues. Reviewer: Suresh Krishnan.
2015-10-14
11 (System) Notify list changed from appsawg-chairs@ietf.org, draft-ietf-appsawg-text-markdown.shepherd@ietf.org, superuser@gmail.com, draft-ietf-appsawg-text-markdown@ietf.org, draft-ietf-appsawg-text-markdown.ad@ietf.org to (None)
2015-09-18
10 Jari Arkko [Ballot Position Update] Position for Jari Arkko has been changed to No Objection from Discuss
2015-09-03
11 Sean Leonard New version available: draft-ietf-appsawg-text-markdown-11.txt
2015-08-31
10 Sean Leonard New version available: draft-ietf-appsawg-text-markdown-10.txt
2015-08-26
09 (System) Sub state has been changed to AD Followup from Revised ID Needed
2015-08-26
09 Sean Leonard IANA Review state changed to Version Changed - Review Needed from IANA - Not OK
2015-08-26
09 Sean Leonard New version available: draft-ietf-appsawg-text-markdown-09.txt
2015-07-09
08 Amy Vezza IESG state changed to IESG Evaluation::Revised I-D Needed from IESG Evaluation
2015-07-09
08 Cindy Morgan Changed consensus to Yes from Unknown
2015-07-09
08 Alia Atlas [Ballot Position Update] New position, No Objection, has been recorded for Alia Atlas
2015-07-09
08 Kathleen Moriarty [Ballot Position Update] New position, No Objection, has been recorded for Kathleen Moriarty
2015-07-09
08 Stephen Farrell
[Ballot comment]

- 1.1: Who says that there's only a 1-dimensional continuum:-)
And what's on the other end? You don't say.

- The 2119 terms …
[Ballot comment]

- 1.1: Who says that there's only a 1-dimensional continuum:-)
And what's on the other end? You don't say.

- The 2119 terms in the para after Figure 1 are bogus, except
for the last SHOULD (on p5).
2015-07-09
08 Stephen Farrell Ballot comment text updated for Stephen Farrell
2015-07-09
08 Stephen Farrell
[Ballot comment]

- 1.1: Who says that there's only a 1-dimensional continuum:-)
And what's on the other end? You don't say.

- The 2119 terms …
[Ballot comment]

- 1.1: Who says that there's only a 1-dimensional continuum:-)
And what's on the other end? You don't say.

- The 2119 terms in the para after Figure 1 are bogus, except
for the last SHOULD (on p5).

- Please respond to the secdir review [1] which raised a couple
of questions that deserve answers. (Apologies if I missed your
answer to that.)

  [1] https://www.ietf.org/mail-archive/web/secdir/current/msg05830.html
2015-07-09
08 Stephen Farrell [Ballot Position Update] New position, No Objection, has been recorded for Stephen Farrell
2015-07-09
08 Spencer Dawkins [Ballot Position Update] New position, No Objection, has been recorded for Spencer Dawkins
2015-07-09
08 Alvaro Retana [Ballot Position Update] New position, No Objection, has been recorded for Alvaro Retana
2015-07-09
08 Martin Stiemerling [Ballot Position Update] New position, No Objection, has been recorded for Martin Stiemerling
2015-07-08
08 Joel Jaeggli [Ballot comment]
Nevil Brownlee performed the opsdir review.
2015-07-08
08 Joel Jaeggli [Ballot Position Update] New position, No Objection, has been recorded for Joel Jaeggli
2015-07-08
08 Terry Manderson [Ballot comment]
Cleared DISCUSS based on WG decision to separate.
2015-07-08
08 Terry Manderson [Ballot Position Update] Position for Terry Manderson has been changed to No Objection from Discuss
2015-07-08
08 Alissa Cooper
[Ballot comment]
I'm not making this a DISCUSS because I think I've raised a similar issue before (with this same AD and doc shepherd, no …
[Ballot comment]
I'm not making this a DISCUSS because I think I've raised a similar issue before (with this same AD and doc shepherd, no less, I think) and lost the argument, but I don't get why this document is informational. It specifies a parameter syntax for fragment identifiers. If one implementation follows the syntax specified here and another implementation uses some other syntax defined somewhere else, how is this spec helping the two implementations interoperate?
2015-07-08
08 Alissa Cooper [Ballot Position Update] New position, No Objection, has been recorded for Alissa Cooper
2015-07-08
08 Jari Arkko
[Ballot discuss]
This is a small issue but there's something wrong with the references. Noted in Suresh Krishnan's Gen-ART review. Please look at this, so …
[Ballot discuss]
This is a small issue but there's something wrong with the references. Noted in Suresh Krishnan's Gen-ART review. Please look at this, so that we are not missing something important:

- RFC 2046 and 2183 are referenced in the text but not defined as
references. Please add them as either normative or informative references.

- RFC5322 is never referenced in the text. Is some intended text missing?
2015-07-08
08 Jari Arkko [Ballot Position Update] New position, Discuss, has been recorded for Jari Arkko
2015-07-08
08 Ben Campbell
[Ballot comment]
1.2, last paragraph:

Is this document attempting to place normative requirements on existing markdown implementations? Or should the 2119 keywords in this section …
[Ballot comment]
1.2, last paragraph:

Is this document attempting to place normative requirements on existing markdown implementations? Or should the 2119 keywords in this section be more statements of fact (and use descriptive language?)

6.1.2, first paragraph, last sentence:
Does this refer to section 6.1.2, or 6.1 and children? If the latter, and if there is no expert reviewer, who is expected to perform those checks (automatically or otherwise?)

Editorial:

IDNits reports a few missing or unused references, please check.

There is at least one occurrence of a word inclosed in slashes like /so/.  I assume that's intended for emphasis--but whether it's for that or some other reason it would be good to explicitly mention it.

section 1.1, last paragraph: Does "author's intent" refer to the author of this draft, or of markdown?

Figure 1: The continuation characters and some markup, impinge on the border.
2015-07-08
08 Ben Campbell [Ballot Position Update] New position, No Objection, has been recorded for Ben Campbell
2015-07-08
08 Deborah Brungard [Ballot Position Update] New position, No Objection, has been recorded for Deborah Brungard
2015-07-08
08 Amy Vezza IESG state changed to IESG Evaluation from Last Call Requested
2015-07-07
08 Terry Manderson Last call was requested
2015-07-07
08 Terry Manderson IESG state changed to Last Call Requested from IESG Evaluation
2015-07-07
08 Terry Manderson Last call announcement was generated
2015-07-07
08 Terry Manderson [Ballot discuss]
I'm holding a discuss on this document given my discuss lodged for draft-ietf-appsawg-text-markdown-use-cases-02.
2015-07-07
08 Terry Manderson [Ballot Position Update] New position, Discuss, has been recorded for Terry Manderson
2015-07-07
08 Shaun Cooley Request for Last Call review by SECDIR Completed: Ready. Reviewer: Shaun Cooley.
2015-07-06
08 Benoît Claise
[Ballot comment]
1.  From Nevil's OPS DIR feedback:
> 2. The markdown Example (Section 5) is helpful, but it doesn't seem
>  to have an …
[Ballot comment]
1.  From Nevil's OPS DIR feedback:
> 2. The markdown Example (Section 5) is helpful, but it doesn't seem
>  to have an obvious end marker - it just runs on into section 6.
>  Does markdown have something like an end-of-file marker you could
>  use to make that obvious?
And answered by Alexey:
>
> Not really, it is a textual format with no special end marker.
>
> I suppose the whole example can be surrounded by some markers and a note added that they are not a part of the example?

could we use the and ?

2. "A companion document [MDMTUSES] provides additional Markdown background and philosophy."

There is more than that. See the draft-ietf-appsawg-text-markdown-use-cases abstract: "Background information, local storage strategies, and additional syntax registrations are supplied"

3. Editorial
OLD: [fOo]
NEW: [foo]
2015-07-06
08 Benoît Claise [Ballot Position Update] New position, No Objection, has been recorded for Benoit Claise
2015-07-06
08 Barry Leiba IESG state changed to IESG Evaluation from Waiting for AD Go-Ahead
2015-07-06
08 Barry Leiba Ballot has been issued
2015-07-06
08 Barry Leiba [Ballot Position Update] New position, Yes, has been recorded for Barry Leiba
2015-07-06
08 Barry Leiba Created "Approve" ballot
2015-07-02
08 Jean Mahoney Request for Last Call review by GENART is assigned to Suresh Krishnan
2015-07-02
08 Jean Mahoney Request for Last Call review by GENART is assigned to Suresh Krishnan
2015-07-02
08 (System) IESG state changed to Waiting for AD Go-Ahead from In Last Call
2015-06-30
08 Gunter Van de Velde Request for Last Call review by OPSDIR Completed: Has Issues. Reviewer: Nevil Brownlee.
2015-06-26
08 Tero Kivinen Request for Last Call review by SECDIR is assigned to Shaun Cooley
2015-06-26
08 Tero Kivinen Request for Last Call review by SECDIR is assigned to Shaun Cooley
2015-06-26
08 Tero Kivinen Closed request for Last Call review by SECDIR with state 'Withdrawn'
2015-06-25
08 Tero Kivinen Request for Last Call review by SECDIR is assigned to Klaas Wierenga
2015-06-25
08 Tero Kivinen Request for Last Call review by SECDIR is assigned to Klaas Wierenga
2015-06-25
08 (System) IANA Review state changed to IANA - Not OK from IANA - Review Needed
2015-06-25
08 Pearl Liang
(Via drafts-lastcall@iana.org): IESG/Authors/WG Chairs:

IANA has reviewed draft-ietf-appsawg-text-markdown-07.  Authors should review the comments and/or questions below.  Please report any inaccuracies and respond to any …
(Via drafts-lastcall@iana.org): IESG/Authors/WG Chairs:

IANA has reviewed draft-ietf-appsawg-text-markdown-07.  Authors should review the comments and/or questions below.  Please report any inaccuracies and respond to any questions as soon as possible.

IANA has questions about the actions requested in the IANA Considerations section of this document.

We received the following comments/questions from the IANA's reviewer:

IANA understands that, upon approval of this document, there are three actions which IANA must complete.

First, in the Media Types registry located at:

http://www.iana.org/assignments/media-types/

a new Media Type in the text subregistry will be created as follows:

Name: markdown
Template: [ TBD-at-Registration ]
Reference: [ RFC-to-be ]

Second, in the Content Disposition Parameters subregistry of the Content Disposition Values and Parameters registry located at:

http://www.iana.org/assignments/cont-disp/

a new disposition parameter will be registered as follows:

Name: preview-type
Description: [ See-Question ]
Reference: [ RFC-to-be ]

QUESTION --> What description should be used for this new Content Disposition Parameter?

Third, a new registry is to be created called the Markdown Variants registry. The new registry will be maintained on a First Come, First Served basis as defined in RFC 5226. IANA notes that the authors request that IANA should confirm the authenticity of the senders of requests for this registry.

QUESTION -> Where should this new registry be located? Is it a néw registry on the IANA Matrix or is it a subregistry of an existing registry? If it is a subregistry of an existing registry, in which registry will it be contained?

IANA understands that the registry contains the following fields: Identifier, Name, Description, Additional Parameters, Fragment Identifiers, References, Contact Information, Expiration Date.

Three variants are to be marked as reserved in the new registry.

QUESTION -> Section 6.1.1 of the current draft provides the three variants to be reserved but none of the other fields to be displayed in the registry. What are the Name, Description, Additional Parameters, Fragment Identifiers, References, Contact Information, and Expiration Date to be used for each of the three reserved variants?

The new registry contains a single, initial registration as follows:

Identifier: Original
Name: Markdown
Description: Gruber's original Markdown syntax
Additional Parameters:
Fragment Identifiers:
References: ,
Contact Information: (individual) John Gruber 
Expiration Date:

IANA understands these three actions as the only ones that need completion upon approval of this document.

Note:  The actions requested in this document will not be completed until the document has been approved for publication as an RFC. This message is only to confirm what actions will be performed.
2015-06-23
08 Gunter Van de Velde Request for Last Call review by OPSDIR is assigned to Nevil Brownlee
2015-06-23
08 Gunter Van de Velde Request for Last Call review by OPSDIR is assigned to Nevil Brownlee
2015-06-19
08 Sean Leonard New version available: draft-ietf-appsawg-text-markdown-08.txt
2015-06-19
07 Barry Leiba Placed on agenda for telechat - 2015-07-09
2015-06-18
07 Jean Mahoney Request for Last Call review by GENART is assigned to Suresh Krishnan
2015-06-18
07 Jean Mahoney Request for Last Call review by GENART is assigned to Suresh Krishnan
2015-06-18
07 Cindy Morgan IANA Review state changed to IANA - Review Needed
2015-06-18
07 Cindy Morgan
The following Last Call announcement was sent out:

From: The IESG
To: IETF-Announce
CC:
Reply-To: ietf@ietf.org
Sender:
Subject: Last Call:  (The text/markdown Media Type) to …
The following Last Call announcement was sent out:

From: The IESG
To: IETF-Announce
CC:
Reply-To: ietf@ietf.org
Sender:
Subject: Last Call:  (The text/markdown Media Type) to Informational RFC


The IESG has received a request from the Applications Area Working Group
WG (appsawg) to consider the following document:
- 'The text/markdown Media Type'
  as Informational RFC

The IESG plans to make a decision in the next few weeks, and solicits
final comments on this action. Please send substantive comments to the
ietf@ietf.org mailing lists by 2015-07-02. Exceptionally, comments may be
sent to iesg@ietf.org instead. In either case, please retain the
beginning of the Subject line to allow automated sorting.

Abstract
  This document registers the text/markdown media type for use with
  Markdown, a family of plain text formatting syntaxes that optionally
  can be converted to formal markup languages such as HTML.

The file can be obtained via
https://datatracker.ietf.org/doc/draft-ietf-appsawg-text-markdown/

Once IESG discussion begins, it can be tracked via
https://datatracker.ietf.org/doc/draft-ietf-appsawg-text-markdown/ballot/

No IPR declarations have been submitted directly on this I-D.

The IANA Considerations section has the following change already noted:

OLD
  All references (including contact information) MUST be verified as
  functional at the time of the registration.

  If a registration is being updated, the contact information MUST
  either match the prior registration and be verified, or the prior
  registrant MUST confirm that the updating registrant has authority to
  update the registration. IANA is to send an email to each old and new
  address confirming the change request. The emails are to contain a
  nonce (which may be embedded in a URI) that, when return by email or
  another mechanism (e.g., HTTP), serve to verify the request. An
  affirmative response from any of the addresses (old or new) is
  sufficient. If neither the old nor the new registrations contain any
  email addresses, then the update MAY succeed without email
  confirmation. Therefore, registrants are encouraged to list at least
  one email address for registration protection.

  As a special "escape valve", registrations can be updated with IETF
  Review [RFC5226]. All fields may be updated except the variant
  identifier, which is permanent: not even case may be changed.

NEW
  All references (including contact information) are expected to be
  valid at the time of the registration.

  All fields may be updated except the variant
  identifier, which is permanent: not even case may be changed.

END

2015-06-18
07 Cindy Morgan IESG state changed to In Last Call from Last Call Requested
2015-06-18
07 Barry Leiba Last call was requested
2015-06-18
07 Barry Leiba Ballot approval text was generated
2015-06-18
07 Barry Leiba IESG state changed to Last Call Requested from AD Evaluation
2015-06-18
07 Barry Leiba Last call announcement was changed
2015-06-18
07 Barry Leiba Last call announcement was generated
2015-06-18
07 Barry Leiba Ballot writeup was changed
2015-06-18
07 Barry Leiba Ballot writeup was generated
2015-06-18
07 Barry Leiba IESG state changed to AD Evaluation from Publication Requested
2015-06-17
07 Murray Kucherawy
1. Summary

Murray Kucherawy is the document shepherd.
Barry Leiba is the responsible Area Director.

This document registers the text/markdown media type for use with …
1. Summary

Murray Kucherawy is the document shepherd.
Barry Leiba is the responsible Area Director.

This document registers the text/markdown media type for use with
Markdown, a family of plain text formatting syntaxes that optionally
can be converted to formal markup languages such as HTML.

The working group has selected Informational status since the markdown
syntax was specified outside of the IETF, and RFC6838 does not require
Standards Track status for a document from the IETF stream registering
a media type.

2. Review and Consensus

The document had fairly active review within APPSAWG at first, but
suffered from some attrition along the way.  Feedback ranged from
"Why does the IETF need to do this?" to whether the entire work
(this plus the use-cases document) should appear in a single document
or in separate documents.  For the latter question, the split was done;
for the former, there are still one or two participants who are unclear
whether this media type or the registries created here will ever be used
by someone other than the author.

Still, there was enough critical mass to get it through a Call For Adoption
and enough reviewers, including both the usual suspects and some outside
participants, that the chairs chose to proceed.

The document evolved over time, being whittled down quite a bit from the
earliest proposals.  The version being sent to the IESG appears to be
minimalist, which is what the WG wanted.

The author and chairs were implored to be sensitive to the markdown community,
which is external to the IETF.  I'm satisfied that this was done as much
as practical.

No particular directorate review is critical here, though the usual ones
should still be done.  The media type reviewer is aware of the work and
has not voiced any objection to the working group, though no specific
request was made for early review either.

The author asserts that he and others have already begun to use the
media type in prototype form within open source and commercial products.

3. Intellectual Property

The author has confirmed that he knows of no outstanding IPR claims, and
thus submits the draft in full compliance with BCPs 78 and 79.

4. Other Points

There are three references to non-IETF URLs in the Normative References.
There is also a normative reference to RFC3778, which is Informational, and
not currently in the DOWNREF Registry.

The IANA Considerations section was checked and needs the following change:

OLD
  All references (including contact information) MUST be verified as
  functional at the time of the registration.

  If a registration is being updated, the contact information MUST
  either match the prior registration and be verified, or the prior
  registrant MUST confirm that the updating registrant has authority to
  update the registration. IANA is to send an email to each old and new
  address confirming the change request. The emails are to contain a
  nonce (which may be embedded in a URI) that, when return by email or
  another mechanism (e.g., HTTP), serve to verify the request. An
  affirmative response from any of the addresses (old or new) is
  sufficient. If neither the old nor the new registrations contain any
  email addresses, then the update MAY succeed without email
  confirmation. Therefore, registrants are encouraged to list at least
  one email address for registration protection.

  As a special "escape valve", registrations can be updated with IETF
  Review [RFC5226]. All fields may be updated except the variant
  identifier, which is permanent: not even case may be changed.

NEW
  All references (including contact information) are expected to be
  valid at the time of the registration.

  All fields may be updated except the variant
  identifier, which is permanent: not even case may be changed.

Nothing else of note.
2015-06-17
07 Murray Kucherawy State Change Notice email list changed to appsawg-chairs@ietf.org, draft-ietf-appsawg-text-markdown.shepherd@ietf.org, superuser@gmail.com, draft-ietf-appsawg-text-markdown@ietf.org, draft-ietf-appsawg-text-markdown.ad@ietf.org
2015-06-17
07 Murray Kucherawy Responsible AD changed to Barry Leiba
2015-06-17
07 Murray Kucherawy IETF WG state changed to Submitted to IESG for Publication from Waiting for WG Chair Go-Ahead
2015-06-17
07 Murray Kucherawy IESG state changed to Publication Requested
2015-06-17
07 Murray Kucherawy IESG process started in state Publication Requested
2015-06-17
07 Murray Kucherawy Tags Author or Editor Needed, Doc Shepherd Follow-up Underway cleared.
2015-06-17
07 Murray Kucherawy Changed document writeup
2015-06-02
07 Murray Kucherawy Tag Author or Editor Needed set.
2015-05-04
07 Murray Kucherawy Tag Doc Shepherd Follow-up Underway set.
2015-05-04
07 Murray Kucherawy Changed document writeup
2015-05-04
07 Murray Kucherawy IETF WG state changed to Waiting for WG Chair Go-Ahead from In WG Last Call
2015-04-20
07 Murray Kucherawy WGLC ends May 1, 2015.
2015-04-20
07 Murray Kucherawy IETF WG state changed to In WG Last Call from WG Document
2015-04-15
07 Sean Leonard New version available: draft-ietf-appsawg-text-markdown-07.txt
2015-04-13
06 Murray Kucherawy Changed document writeup
2015-03-09
06 Sean Leonard New version available: draft-ietf-appsawg-text-markdown-06.txt
2014-12-22
05 Sean Leonard New version available: draft-ietf-appsawg-text-markdown-05.txt
2014-12-16
04 Sean Leonard New version available: draft-ietf-appsawg-text-markdown-04.txt
2014-10-17
03 Sean Leonard New version available: draft-ietf-appsawg-text-markdown-03.txt
2014-09-22
02 Sean Leonard New version available: draft-ietf-appsawg-text-markdown-02.txt
2014-09-09
01 Sean Leonard New version available: draft-ietf-appsawg-text-markdown-01.txt
2014-09-09
00 Murray Kucherawy Document shepherd changed to Murray Kucherawy
2014-09-09
00 Murray Kucherawy Intended Status changed to Informational from None
2014-09-09
00 Murray Kucherawy This document now replaces draft-seantek-text-markdown-media-type instead of None
2014-09-09
00 Sean Leonard New version available: draft-ietf-appsawg-text-markdown-00.txt