Subject: RE: Last Call: <draft-freytag-lager-variant-rules-02.txt> (Variant Rules) to Informational RFC

From: "Hollenbeck, Scott" <[email-masked]>
Date: Tue, 24 Jan 2017 15:08:17 +0000

> -----Original Message-----
> From: IETF-Announce [mailto:[email-masked]] On Behalf
> Of The IESG
> Sent: Tuesday, January 17, 2017 12:23 PM
> To: IETF-Announce
> Cc: [email-masked]; draft-freytag-lager-variant-
> [email-masked]
> Subject: [EXTERNAL] Last Call: <draft-freytag-lager-variant-rules-
> 02.txt> (Variant Rules) to Informational RFC
> 
> 
> The IESG has received a request from an individual submitter to
> consider
> the following document:
> - 'Variant Rules'
>   <draft-freytag-lager-variant-rules-02.txt> 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
> [email-masked] mailing lists by 2017-02-14. Exceptionally, comments may
> be
> sent to [email-masked] instead. In either case, please retain the
> beginning of the Subject line to allow automated sorting.

I am the shepherd for this document. I'd like to share my review comments here. Please note that the document has been updated to version -03 since the last call announcement was sent and I am reviewing the -03 version.

The title of the document is "Variant Rules". It might be helpful to add a few words to very clearly identify what these rules are for. Perhaps something like "Domain Name Variant Label Generation Rules"?

In the abstract, it would be helpful to add a few words to clearly note that "labels" refers to domain names.

OLD:
This document gives guidance on designing well-behaved Label Generation Rulesets (LGRs) that support variant labels.

NEW:
This document gives guidance on designing well-behaved Label Generation Rulesets (LGRs) that support variant labels for domain names.

Section 1:

The first paragraph uses the "LGR" acronym for "Label Generation Rulesets"; the Abstract uses "LGRs". Please use one or the other consistently throughout the document, at least in places where the acronym is expanded.

"When it comes time to capture the LGR in a formal definition, the notation used in this document can be converted to the XML format fairly directly."

Please add a forward reference to Section 16.

NEW (just a suggestion):
"When it comes time to capture the LGR in a formal definition, the notation used in this document can be converted to the XML format fairly directly as described in Section 16 [XMLNotation]."

These are all minor issues. Please hold off on making document edits until others have had a chance to share their comments.

Scott