Re: LC: draft-ietf-forces-protocol-10.txt>>comments
"tom.petch" <[email protected]> Fri, 15 Jun 2007 10:49:15 +0200
| Newsgroups | gmane.ietf.forces |
|---|---|
| Message-ID | <005901c7af2a$59123080$0601a8c0@pc6> |
I would like to see some more explicit terminology. (I struggled last autumn to understand -model and think that I will not be the last). Above all, Section 6.4.1 needs more detail - I would add "For any particular entity, this 32-bit identifier is assigned by the XML attribute "elementID" in the XML element "attribute"; for examples of this, see Appendix B." (personally I would put this in bold, block capitals and use it as a running footing but recognise that most would see this as overkill:-). "SNMP MIB" should be "SNMP MIB Module" - the MIB is the virtual data store in the Command Responder, the definition thereof in SMIv2 in an RFC is a MIB Module. "scalars or vectors" says to me zero or one dimension; -model uses arrays and structures which suggests more; I would like consistency. Everyone know "dot-notation (e.g., 1.2.3.4)." and knows that it means x'01020304' don't they? Or is the dot used here to separate the elementIDs in the path? Appendix B has "6.10.1.20.1" so presumable this is not dot-notatation but ... You should spell it out and if the latter is meant, then put a number over 256 in the example e.g., 1.3.359 to reinforce the message. Section 7; if the IDs in IDcount and IDs are element IDs (as opposed to the other IDs defined in this document), then I would like that explicitly stated Appendix B should state explicitly that it is normative; a common convention is that appendices are not and some might, like me, expect the normative version of the LFB to be in -model "model draft" appears in several places - since this is a normative reference, the model must be an RFC when this is "Section (Section " appears in several places; not an XML problem surely:-) Tom Petch