I understand the primary need is to make the YANG modules accessible to readers, but some simple markup is identical to how text might be formatted when only raw ASCII is available (e.g. when using a simple email client) yet, when rendered as markup, the resulting text is easier on the eyes of the reader.
I agree that some examples may better sell the idea. Also, if some YANG authors are already including markup, wouldn't it be better to standardise rather than allow for a free-for-all resulting in multiple styles that would impose a significant burden on any tool trying to render the text. Jonathan =O) On 19 Apr 2017, 22:05 +0100, Kent Watsen <[email protected]>, wrote: > > All, > > We're a couple days away from the 2-week window. As of now, the > majority does not support adopting this draft. Any remaining > opinions? > > > Lada, > > The objections seem to be concern for net readability, and for the > importance of the problem relative to other activities. For the > former case, it may help if you posted some examples. For the > latter case, we may want to keep this draft cooking in the > background. > > > Kent // as co-chair and potential shepherd > > > > Phil Shafer <[email protected]> writes: > > > Andy Bierman writes: > > > IMO it is more robust not to assume people never see the real YANG > > > statements. > > > > Exactly. We made YANG readable so that we wouldn't _need_ to view > > it using tools. This was one of the "insta-death" factors for UML. > > I have to reiterate that the idea is to continue to be able to view YANG > modules *without* using tools, but provide some aid to tools that can make > use of certain well-defined lightweight markup conventions. > > Everybody with a practical experience of converting YANG automatically > to something else (not only to HTML, it starts already with YIN) knows > that transferring descriptions and other similar texts is tricky. > > Lada > > > > > Thanks, > > Phil > > > > _______________________________________________ > > netmod mailing list > > [email protected] > > https://www.ietf.org/mailman/listinfo/netmod > > -- > Ladislav Lhotka, CZ.NIC Labs > PGP Key ID: 0xB8F92B08A9F76C67 > > _______________________________________________ > netmod mailing list > [email protected] > https://www.ietf.org/mailman/listinfo/netmod > > > _______________________________________________ > netmod mailing list > [email protected] > https://www.ietf.org/mailman/listinfo/netmod
_______________________________________________ netmod mailing list [email protected] https://www.ietf.org/mailman/listinfo/netmod
