Document: draft-ietf-opsawg-rfc5706bis Title: Guidelines for Considering Operations and Management in IETF Specifications Reviewer: Martin Björklund Review result: Ready with Nits
Hi, This is my YANG doctors review of draft-ietf-opsawg-rfc5706bis-01. This document contains general guidelines for operational considerations in IETF documents. From a YANG point of view, it doesn't contain any YANG models, but provides some guidelines on when and how to use YANG. I have just one question and it is regarding the recommendations for Information Models (IM). The draft has an implicit recommendation in section 5.3: Although this document recommends using English text (the official language for IETF specifications) to describe an Information Model, including a complementary YANG module helps translate abstract concepts into implementation-specific Data Models. It later says in 5.3.1: When defining an Information Model using YANG Data Structure Extensions [...] It is not clear to me what you mean here. In section 5.3 it seems you recommend including a Data Model YANG module (not an IM, since the IM is in english text). But then in 5.3.1 you mention a YANG module for the IM as well, but there is no other discussion about using YANG for the IM. Also, I think it would be clearer to have an explicit recommendation in section 5.3: This document recommends using English text... /martin _______________________________________________ OPSAWG mailing list -- [email protected] To unsubscribe send an email to [email protected]
