Juergen Schoenwaelder <[email protected]> wrote: > On Mon, May 23, 2016 at 03:43:09PM +0200, Martin Bjorklund wrote: > > > [email protected] (Dale R. Worley) wrote: > > > > > > - Abstract > > > > > > This Abstract does not list what the document does. E.g., define Yang > > > 1.1. Also might help to mention upward-incompatibility. Basically, > > > go through section 1 to see what should be in Abstract. Perhaps: > > > > > > YANG is a data modeling language originally designed to model > > > configuration and state data manipulated by the Network > > > Configuration Protocol (NETCONF), NETCONF remote procedure calls, > > > and NETCONF notifications. This document describes the syntax and > > > semantics of version 1.1 of the YANG language. YANG version 1.1 is > > > a maintenance release of the YANG language, addressing ambiguities > > > and defects in the original specification. There are a small > > > number of upward-incompatibilities from Yang 1. This document also > > > describes how a data model defined in a YANG module is encoded in > > > the Extensible Markup Language (XML), and how NETCONF operations > > > are used to manipulate the data. > > > > Ok, but note that the abstract was changed a bit in -12, so > > incorporapting your proposed changes it would be: > > > > YANG is a data modeling language used to model configuration data, > > state data, remote procedure calls, and notifications for network > > management protocols. This document describes the syntax and > > semantics of version 1.1 of the YANG language. YANG version 1.1 is > > a maintenance release of the YANG language, addressing ambiguities > > and defects in the original specification. There are a small number > > of backward-incompatibilities from YANG version 1. This document also > > specifies the YANG mappings to the Network Configuration Protocol > > (NETCONF). > > Do we have to mention actions in the first sentence as well?
I think it would be better to use a more generic term for rpc + actions. Maybe operations: YANG is a data modeling language used to model configuration data, state data, operations, and notifications for network management protocols. But maybe it doesn't even matter; maybe the current text is ok for the high-level Abstract; you might say that an action is a special kind of remote procedure call. /martin _______________________________________________ netmod mailing list [email protected] https://www.ietf.org/mailman/listinfo/netmod
