[netmod] Re: Paul Wouters' Discuss on draft-ietf-netmod-syslog-model-32: (with DISCUSS and COMMENT)

[Kent Watsen <[e-mail]>]

[removing the IESG]


Hi Joe, authors, and NETMOD.

> On Sep 10, 2024, at 10:04 AM, Joe Clarke (jclarke) <jclarke=[e-mail]> wrote:
> 
> Thanks for the comments and feedback, Paul.  I’ve opened GitHub issue https://github.com/netmod-wg/syslog-model/issues/14 so Mahesh and I can track the necessary changes on our end.  See below for some initial responses.
>  
> The layout is completely broken / wrapped, making the document fairly
> unreadable. Can this be fixed somehow ?
> 
>  
> 
> [JMC] Éric had the same comment, and I thought we’d be good just expanding the full tree.  However, it seems this is causing readability and confusion problems. 
> 
I ran into a similar “wrapping tree diagrams is ugly" comment in the suite of client-server drafts.   Not expanding the groupings in the tree diagrams helps, but still may not be enough - you just need to try and see how it looks.  That said, there is still one thing that can be done to improve the appearance of *folded” tree diagrams, which is epitomized by the following RFC Editor comment put into the documents:

         <t>Tree-diagrams in this draft may use the '&#92;' line-folding mode defined in RFC 8792.
           However, nicer-to-the-eye is when the '&#92;&#92;' line-folding mode is used.  The AD suggested
           suggested putting a request here for the RFC Editor to help convert "ugly" '&#92;' folded
           examples to use the '&#92;&#92;' folding mode.  "Help convert" may be interpreted as, identify
           what looks ugly and ask the authors to make the adjustment.</t>

PS: there is a desire to have Datatracker *unfold* folded artwork/sourcecode for document output formats that can support horizontal scrolling.  Specifically, for an HTML-rendered document, the ideal is for examples to be unfolded and placed into a textbox that causes a browser to create a textbox with horizontal scrolling.   I’m unsure if there is an open-ticket for this work to get done.

Kent // as contributor