Hi all, This is my AD review for draft-ietf-regext-epp-registry-maintenance.
General: The use of "maintenance" in this document is sometimes awkward to me, especially in its plural form. For instance, the first sentence of the introduction includes "conduct maintenances", which reads oddly. I think I would suggest "conduct maintenance", and change "upcoming maintenances" to "upcoming maintenance events" (as was done in Section 3.3) or "upcoming maintenance windows". Abstract: Should "registry's" perhaps be "registries" or "a registry's"? Actually perhaps this is a better solution: NEW: This document describes an Extensible Provisioning Protocol (EPP) extension called "Registry Maintenance Notifications", used by EPP clients and servers to notify each other about maintenance events. (END) Section 1: I can't quite parse this sentence: This mapping provides a mechanism by which EPP servers may notify and EPP clients to query upcoming maintenances. Section 2 starts talking about particular EPP elements and commands. I think Section 1 should include a normative reference to EPP or some other document where these are defined. Section 3.2: "All dates and times attribute values ..." -- s/dates and times/date and time/ Section 3.3: What does "the name of the maintenance" mean? Is this something like a headline or title, or a more complete description? Also Section 3.3: If there might ever be a need to add more pollType values, or deprecate one of the ones listed, you might want to consider creating a registry for them. If not, this whole document needs to be updated or revised to include the new values. I have the same question about "<maint:reason>", "<maint:impact>", "<maint:environment>", and all of the others whose possible values are expressly enumerated. Also Section 3.3: For "<maint:environment>", what is "ote"? Also Section 3.3: In the examples, the "<maint:id>" seems to be a UUID. Is this at the discretion of the implementation (i.e., any format for the identifier is fine), or should this be constrained explicitly here? Thank you for including Section 8. -MSK
_______________________________________________ regext mailing list regext@ietf.org https://www.ietf.org/mailman/listinfo/regext
