[yang-doctors] review of IEEE P802.1Qcp

[Juergen Schoenwaelder <[e-mail]>]

Hi,

attached is my review of P802.1Qcp. As usual, there are things related
to YANG usage (is the YANG usage correct and proper?) and there are
things related to the data model of the bridge technology (is the YANG
model correct and proper?). Since I am not an expert on bridge
technology, I can't really judge the later but from the way the data
model is written it seems not everything is a correct model.

If you want to substantially improve the model and the trust in the
model being correct, here is what I recommend you to do:

- Find volunteers familiar with bridg technology (not editors of the
  YANG data model) and let them write configurations and state data
  according to the YANG data model, ideally a few simple bridge
  configs and a few more complex ones. We sometimes call these configs
  instance documents. There are tools to validate instance documents
  against the data model.

- Usually the volunteers writing instance documents spot bugs where
  the model is wrong (I do not know how I configure XYZ in the model)
  and they spot points where instance documents are unnecessarily
  verbose or complex.

- Get the YANG data model editor and the volunteers writing instance
  documents together to resolve all conflicts until the instance
  documents are all nice and complete.

Sounds like a lot of work and yes it is a lot of work. But it is
essential to do this exercise if you want to have a high quality
product.

/js

-- 
Juergen Schoenwaelder           Jacobs University Bremen gGmbH
Phone: [phone]         Campus Ring 1 | 28759 Bremen | Germany
Fax:   [phone]         <http://www.jacobs-university.de/>