Hi Linlin
Here is my review of draft-ietf-regext-org-ext-06. Only small details.
===
The abstract is a bit different than all other RFCs.
I would start with This document describes ... and I would also add the whole
XML blah blah (Specified in XML, this mapping...)
===
In 2. Conventions, append the following text
> The XML namespace prefix "orgext" is
> used, but implementations MUST NOT depend on it and instead employ a
> proper namespace-aware XML parser and serializer to interpret and
> output the XML documents.
===
> 3.1 <https://tools.ietf.org/html/draft-ietf-regext-org-ext-06#section-3.1>.
> Organization Identifier
Detail, but change <organization:id> to <org:id> ? It is the prefix used in the
other draft.
===
> 4 <https://tools.ietf.org/html/draft-ietf-regext-org-ext-06#section-4>. EPP
> Command Mapping
> A detailed description of the EPP syntax and semantics can be found
> in the EPP core protocol specification [RFC5730
> <https://tools.ietf.org/html/rfc5730>]. The command
> mappings described here are specifically for use in provisioning and
> managing organization information via EPP.
This is not completely true. This draft is about assigning/linking
organizations to other EPP objects, it's not about provisioning/managing
organizations.
===
> 4.1 <https://tools.ietf.org/html/draft-ietf-regext-org-ext-06#section-4.1>.
> EPP Query Commands
> EPP provides three commands to retrieve domain information: <check>
> to determine if a domain object can be provisioned within a
> repository, <info> to retrieve detailed information associated with a
> domain object, and <transfer> to retrieve domain-object transfer
> status information.
Opinion: I would not emphasise on domains in the text, and only refer domain
objects in the examples. I would also not repeat the 3 EPP object mappings at
various places, as it is already mentioned in the intro that it applies to all
object mappings. It makes the text less verbose.
So, e.g. for 4.1 I would write
EPP provides three commands to retrieve EPP object information: <check>
to determine if an object is known to the server, <info> to retrieve
detailed information associated with an object, and <transfer> to
retrieve object transfer status information.
Same for 4.2
Another example, throughout the document: replace
> EPP domain mapping [RFC5731 <https://tools.ietf.org/html/rfc5731>],
> host mapping [RFC5732 <https://tools.ietf.org/html/rfc5732>] and contact
> mapping [RFC5733 <https://tools.ietf.org/html/rfc5733>].
with
> EPP object mapping
===
> The EPP <update> command provides a transform operation that allows a
> client to modify the attribute of an object.
attributes (plural)
No other remarks,
Kind regards
Pieter
_______________________________________________
regext mailing list
regext@ietf.org
https://www.ietf.org/mailman/listinfo/regext
