Re: [netmod] reflow of YANG descriptions, and general YANG format annoyances

2020-11-09 Thread Ladislav Lhotka
Hi,

my solution that I've been using for years is to write YANG modules in the YIN 
syntax. With the nXML mode of emacs this is actually rather effective 
(statement completion, on-the-fly validation).

I also extended the YIN syntax with a few XML elements from the XHTML 
namespace. This helps me to handle paragraphs and lists in a safe way.

Descriptions etc. are then reflowed automatically as a part of XSLT transform 
to the compact YANG syntax.

Here are the details:

https://gitlab.nic.cz/labs/yang-tools/-/wikis/editing_yang

See also https://github.com/llhotka/YANG-I-D

Lada

Michael Richardson  writes:

> As people do more YANG modules, more and more logic and description moves
> from regular text into the YANG module.  Where it is awkward and annoying to
> edit.
>
> And references from YANG modules don't get counted/resolved/updated, and
> all sorts things that the XML format was designed to solve have basically
> reverted to 1996 era (without even nroff) when it comes text in the YANG 
> module.
>
> In one of my drafts, I guess some minor wording tweaks in one draft leads to
> some lines exceeding 72 characters (by one). Argh. Change from C-mode to
> text-mode. reflow.
>
> It seems like we should be thinking about what to do here.
> I was introduced to the SED method of fixing yang MMDD version
> references.
>
> While I like YANG as executable "code", it sure feels like it is not smart to
> be authoring in it.
>
> --
> Michael Richardson. o O ( IPv6 IøT consulting )
>Sandelman Software Works Inc, Ottawa and Worldwide
> ___
> netmod mailing list
> netmod@ietf.org
> https://www.ietf.org/mailman/listinfo/netmod

-- 
Ladislav Lhotka 
Head, CZ.NIC Labs
PGP Key ID: 0xB8F92B08A9F76C67

___
netmod mailing list
netmod@ietf.org
https://www.ietf.org/mailman/listinfo/netmod


[netmod] reflow of YANG descriptions, and general YANG format annoyances

2020-11-06 Thread Michael Richardson

As people do more YANG modules, more and more logic and description moves
from regular text into the YANG module.  Where it is awkward and annoying to
edit.

And references from YANG modules don't get counted/resolved/updated, and
all sorts things that the XML format was designed to solve have basically
reverted to 1996 era (without even nroff) when it comes text in the YANG module.

In one of my drafts, I guess some minor wording tweaks in one draft leads to
some lines exceeding 72 characters (by one). Argh. Change from C-mode to
text-mode. reflow.

It seems like we should be thinking about what to do here.
I was introduced to the SED method of fixing yang MMDD version
references.

While I like YANG as executable "code", it sure feels like it is not smart to
be authoring in it.

--
Michael Richardson. o O ( IPv6 IøT consulting )
   Sandelman Software Works Inc, Ottawa and Worldwide


signature.asc
Description: PGP signature
___
netmod mailing list
netmod@ietf.org
https://www.ietf.org/mailman/listinfo/netmod