On Wed, May 25, 2016 at 12:12:11PM +0200, Martin Bjorklund wrote: > Juergen Schoenwaelder <j.schoenwael...@jacobs-university.de> wrote: > > On Mon, May 23, 2016 at 03:43:09PM +0200, Martin Bjorklund wrote: > > > > > wor...@ariadne.com (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. I like 'operations' and the notion of operations = rpcs + actions. /js
-- Juergen Schoenwaelder Jacobs University Bremen gGmbH Phone: +49 421 200 3587 Campus Ring 1 | 28759 Bremen | Germany Fax: +49 421 200 3103 <http://www.jacobs-university.de/> _______________________________________________ netmod mailing list netmod@ietf.org https://www.ietf.org/mailman/listinfo/netmod