Last Call Review of draft-ietf-appsawg-text-markdown-08
review-ietf-appsawg-text-markdown-08-opsdir-lc-brownlee-2015-06-30-00

Request Review of draft-ietf-appsawg-text-markdown
Requested rev. no specific revision (document currently at 12)
Type Last Call Review
Team Ops Directorate (opsdir)
Deadline 2015-07-02
Requested 2015-06-23
Authors Sean Leonard
Draft last updated 2015-06-30
Completed reviews Genart Last Call review of -07 by Suresh Krishnan (diff)
Genart Last Call review of -08 by Suresh Krishnan (diff)
Secdir Last Call review of -08 by Shaun Cooley (diff)
Opsdir Last Call review of -08 by Nevil Brownlee (diff)
Assignment Reviewer Nevil Brownlee
State Completed
Review review-ietf-appsawg-text-markdown-08-opsdir-lc-brownlee-2015-06-30
Reviewed rev. 08 (document currently at 12)
Review result Has Issues
Review completed: 2015-06-30

Review
review-ietf-appsawg-text-markdown-08-opsdir-lc-brownlee-2015-06-30

Hi all:

I have performed an Operations Directorate review of
   draft-ietf-appsawg-text-markdown-08

  "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."

- - - -

In a little more detail, this draft explains what markdown is, asks
to register a text/markdown Media Type (using the template set out
in RFC 6838), and also to create a Registry called Markdown Variants
that will contain the names of commonly-used variants.

I have two issues:

1. The last sentence of the request for a Markdown Variants Registry
   (section 6.1) says '[MDMTUSES] includes additional registrations,'
   but MDMTUSES is an informational reference.  If the variants it
   describes are to go into the Registry, should it be a normative
   reference?

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?

Apart from these minor quibbles, a good document, ready for publication.

Cheers, Nevil
Ex Co-chair, EMAN WG (now closed)
Ex Co-chair, IPFIX WG (now closed)
--
---------------------------------------------------------------------
 Nevil Brownlee                          Computer Science Department
 Phone: +64 9 373 7599 x88941             The University of Auckland
 FAX: +64 9 373 7453   Private Bag 92019, Auckland 1142, New Zealand