Hi, I support this work. See below for some comments.
Qin Wu <[email protected]> wrote: > Dear WG, > > As you may recall I presented yang-xml-doc-conventions in London. > There was strong support for trying to solve the problem and mixed > views on the solution, other than that we should do it fast. In the > meanwhile, Kent submitted artwork-folding as an alternative solution. > > The authors of the two drafts decided to combine efforts. After > several internal iterations on both drafts, the drafts were becoming > more alike than different(both support auto wrapping or auto folding). > The artwork-folding draft was selected as a preferred offering basis > (i.e., draft-kwatsen-netmod-artwork-folding-04) to the working group > to consider for adoption. > > The primary feature differences remained are: > - all folded lines continue of column 0 without two character > indentation, i.e., whether auto indentation should be supported. I really liked the flexible indentation in the other draft. I suggest it is added to this draft. It enhances readability (if the author wants it). > - handle two special case on backslash and space at the end of broken > line in yang-xml-doc-conventions. > - propose to use <WRAPPED TEXT BEGIN><WRAPPED TEXT END> to extract > artwork from I-Ds. The artwork draft proposes only a header, which means that it is not quite clear where the artwork ends. In the artwork draft, section 5.3, you write: This line is self-describing in three ways: use of '\' character, identification of BCP/RFC, and identification of what the maximum line length is for the artwork. I was confused about this maximum line length; it seems you define the maximum line length ot be 53, but that seems too limiting, and indeed in the example in 5.4 the max line length is 69. (BTW, the example is missing in the draft, as is the shell script in Appendix A). In any case, I don't see how the header identifies the max line length. Also, in section 5.2, the first sentence is: Scan the artwork to see if any line exceeds the desired maximum. But what is the desired maximum? I assume that the idea is that the author first selects a desired max? Maybe add a line that explains this, and again write that 69 is a reasonable value for use in I-Ds and RFCs. /martin > > Thanks, > Qin, Kent, Benoit and Adrian > -----邮件原件----- > 发件人: [email protected] [mailto:[email protected]] > 发送时间: 2018年6月23日 9:33 > 收件人: Benoit Claise; Qin Wu; Kent Watsen; Adrian Farrel; Benoît > Claise > 主题: New Version Notification for > draft-kwatsen-netmod-artwork-folding-04.txt > > > A new version of I-D, draft-kwatsen-netmod-artwork-folding-04.txt > has been successfully submitted by Qin Wu and posted to the IETF > repository. > > Name: draft-kwatsen-netmod-artwork-folding > Revision: 04 > Title: Handling Long Lines in Artwork in Drafts > Document date: 2018-06-22 > Group: Individual Submission > Pages: 9 > URL: > https://www.ietf.org/internet-drafts/draft-kwatsen-netmod-artwork-folding-04.txt > Status: > https://datatracker.ietf.org/doc/draft-kwatsen-netmod-artwork-folding/ > Htmlized: > https://tools.ietf.org/html/draft-kwatsen-netmod-artwork-folding-04 > Htmlized: > https://datatracker.ietf.org/doc/html/draft-kwatsen-netmod-artwork-folding > Diff: > https://www.ietf.org/rfcdiff?url2=draft-kwatsen-netmod-artwork-folding-04 > > Abstract: > This document introduces a simple and yet time-proven strategy for > handling long lines in artwork in drafts using a backslash ('\') > character where line-folding has occurred. The strategy works on any > text based artwork, producing consistent results regardless the > artwork content. Using a per-artwork header, the strategy is both > self-documenting and enables automated reconstitution of the original > artwork. > > > > > > Please note that it may take a couple of minutes from the time of > submission until the htmlized version and diff are available at > tools.ietf.org. > > The IETF Secretariat > > _______________________________________________ > netmod mailing list > [email protected] > https://www.ietf.org/mailman/listinfo/netmod _______________________________________________ netmod mailing list [email protected] https://www.ietf.org/mailman/listinfo/netmod
