Subject: [nmrg] My review of: draft-schoenw-sming-lessons-00.txt
From: "Wijnen, Bert \(Bert\)" <[email-masked]>
To: <[email-masked]>
Cc: [email-masked]
Date: Tue, 7 Aug 2007 16:40:51 +0200
List-Id: Network Management Research Group <nmrg.ibr.cs.tu-bs.de>

In general, I think this is a quite useful document.
For novice readers (those not directly involved with some
of the SMIng history), it might be helpful if a few
examples are included in various subsections of section 3.

Nits/typos:

- section 1

   started in the late 1999 and concluded with the publication of the

   s/the// 
   or s/1999/1990s/
   probably the 1st one.

- section 2

   of SMIv2, the current data modeling language for management
   information bases.  Primarily, its partial dependence on ASN.1 and a
  
  s/management information bases/the management information base/
  or s/base/base modules/

- sect 2
  you may want to expand acronyms when they are first used (like RAP, 
  COPS-PR, SPPI)

- sect 2

  Working Group on COPS-PR and SPPI emerged in 1999/2000, SMIng was
  split into two parts: a core data definition language (defined in
  this document) and protocol mappings to allow the application of core

  (defined in this document) ?? You mean in RFC3780 I guess?
  seems you copied some (or all) if this from RFC3780

- sect 3.2, 4th bullet
      document, it becomes more natural to support course grained atomic

  s/course/coarse/ ?

- sect 3.3, rd bullet
      sharing properties may be implicit in the naming system used in
      once protocol mapping while they must be explicit in other

  s/once/one/ ??

- sect 3.9
   language supports a suitable versioning model and that it established
 
  s/established/establishes/ ?

   modeling language may be less of an issue since such information can
   often be maintained in revision control systems and automatically
   places into comments where needed.

  s/places/placed/ ?

- sect 3.10
   supports language extensions, it should be possible to gradually
   introduction of new language features.

  s/introduction of/introduce/ ??

- sect 3.11
   Once way to define a new data modeling language is to start from an

  s/Once/One/

>From IDNITS:
 == Unused Reference: 'RFC3084' is defined on line 422, but no explicit
     reference was found in the text

Bert Wijnen  

> -----Original Message-----
> From: [email-masked] 
> [mailto:[email-masked]] On Behalf Of Juergen 
> Schoenwaelder
> Sent: Monday, June 18, 2007 10:36 PM
> To: [email-masked]
> Subject: [nmrg] [[email-masked]: 
> I-DACTION:draft-schoenw-sming-lessons-00.txt]
> 
> Hi,
> 
> at the last NMRG meeting in Prague, during the general 
> discussion, the question was raised what the NMRG can 
> contribute to the data modeling discussion. I then made a 
> comment that it might help if we can document technical 
> lessons learned from the SMIng project.
> 
> Below is a first attempt to write down some lessons learned. 
> I am looking for your feedback, both technically and in more 
> general whether such a document is of any value to be 
> published (and if so in which form).
> 
> /js
> 
> ----- Forwarded message from [email-masked] -----
> 
> To: [email-masked]
> Cc: 
> From: [email-masked]
> Date: Mon, 18 Jun 2007 15:50:02 -0400
> Subject: I-D ACTION:draft-schoenw-sming-lessons-00.txt
> Precedence: list
> Reply-To: [email-masked]
> Errors-To: [email-masked]
> 
> A New Internet-Draft is available from the on-line 
> Internet-Drafts directories.
> 
> 
> 	Title		: Lessons Learned from the SMIng Project
> 	Author(s)	: J. Schoenwaelder
> 	Filename	: draft-schoenw-sming-lessons-00.txt
> 	Pages		: 12
> 	Date		: 2007-6-18
> 	
>    A data modeling language for network management protocols called
>    SMIng was developed within the Network Management Research Group of
>    the Internet Research Task Force over a period of several years.
>    This memo documents some of the lessons learned during the project
>    for consideration by designers of future data modeling 
> languages for
>    network management protocols.
> 
> 
> A URL for this Internet-Draft is:
> http://www.ietf.org/internet-drafts/draft-schoenw-sming-lessons-00.txt
> 
> To remove yourself from the I-D Announcement list, send a message to 
> [email-masked] with the word unsubscribe in 
> the body of 
> the message. 
> You can also visit 
> https://www1.ietf.org/mailman/listinfo/I-D-announce 
> to change your subscription settings.
> 
> Internet-Drafts are also available by anonymous FTP. Login with the 
> username "anonymous" and a password of your e-mail address. After 
> logging in, type "cd internet-drafts" and then 
> "get draft-schoenw-sming-lessons-00.txt".
> 
> A list of Internet-Drafts directories can be found in
> http://www.ietf.org/shadow.html 
> or ftp://ftp.ietf.org/ietf/1shadow-sites.txt
> 
> Internet-Drafts can also be obtained by e-mail.
> 
> Send a message to:
> 	[email-masked].
> In the body type:
> 	"FILE /internet-drafts/draft-schoenw-sming-lessons-00.txt".
> 	
> NOTE:	The mail server at ietf.org can return the document in
> 	MIME-encoded form by using the "mpack" utility.  To use this
> 	feature, insert the command "ENCODING mime" before the "FILE"
> 	command.  To decode the response(s), you will need "munpack" or
> 	a MIME-compliant mail reader.  Different MIME-compliant 
> mail readers
> 	exhibit different behavior, especially when dealing with
> 	"multipart" MIME messages (i.e. documents which have been split
> 	up into multiple messages), so check your local documentation on
> 	how to manipulate these messages.
> 
> Below is the data which will enable a MIME compliant mail reader
> implementation to automatically retrieve the ASCII version of the
> Internet-Draft.
> 
> 
> _______________________________________________
> I-D-Announce mailing list
> [email-masked]
> https://www1.ietf.org/mailman/listinfo/i-d-announce
> 
> 
> ----- End forwarded message -----
> 
> -- 
> 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/>
> -- 
> !! This message is brought to you via the `nmrg' mailing list.
> !! Please do not reply to this message to unsubscribe. To 
> unsubscribe or adjust
> !! your settings, send a mail message to 
> <[email-masked]>
> !! or look at https://mail.ibr.cs.tu-bs.de/mailman/listinfo/nmrg.
>