[removing the IESG]
Hi Joe, authors, and NETMOD. > On Sep 10, 2024, at 10:04 AM, Joe Clarke (jclarke) > <[email protected]> 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 '\' line-folding mode defined in RFC 8792. However, nicer-to-the-eye is when the '\\' line-folding mode is used. The AD suggested suggested putting a request here for the RFC Editor to help convert "ugly" '\' folded examples to use the '\\' 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
_______________________________________________ netmod mailing list -- [email protected] To unsubscribe send an email to [email protected]
