Re: [xml2rfc-dev] Please help review v3 files

[Heather Flanagan <[e-mail]>]

Here you go:

https://github.com/rfc-format/draft-iab-rfc-css-bis/tree/master/docs

And than you in advance for your PRs!

-Heather

Sent from my iPad

> On Jul 21, 2019, at 13:55, Martin Thomson <[e-mail]> wrote:
> 
> Hi Sandy,
> 
> Heather tells me that these style sheets are on GitHub and requested that I provide assistance in the form of pull requests.
> 
> I'd love to do that, but I can't find them.  Would you mind pointing me (and the list) at the repository?
> 
> Cheers,
> Martin
> 
> 
>> On Sat, Jul 20, 2019, at 09:25, Martin Thomson wrote:
>> I only looked at the first example.
>> 
>> The table of contents overlay is not great for the reasons Carsten 
>> cited.  The spacing between items there is strange.
>> 
>> The references are similarly strangely formatted.  I think that is just 
>> the choice of really large anchor names [I-D.ietf-blablabla] rather 
>> than using shorter symbolic names though.
>> 
>> I don't like the choice of font, but I concede that this is subjective.
>> 
>> The use of small caps for the "(EDITOR)" designation is jarring.
>> 
>> The weight of the paragraph anchors is enough that it is very distracting.
>> 
>> Line lengths are too long.  https://typographyforlawyers.com/line-length.html
>> 
>> There are too many different font styles in use, particularly in the 
>> front matter.  The guidance we got from a professional designer is that 
>> you need to reduce the number of variations and that each change should 
>> only alter one thing (size, italic, bold, font, etc...)
>> 
>> There are also a bunch of things that are likely the result of problems 
>> in the source document.
>> 
>> The contributors section seems to be badly formatted in HTML.
>> 
>> The formatting of the insets in Section 4.2.1 is odd.
>> 
>> The indentation in Section 4.3 is odd.
>> 
>> Authors have errant commas.
>> 
>> The ordering of the trailing sections is a little hard to understand.  
>> There are contributors, then references, then authors.
>> 
>> In comparison, 
>> https://quicwg.org/base-drafts/draft-ietf-quic-transport.html has none 
>> of these problems.  It also (subjectively) looks much nicer.
>> 
>>> On Thu, Jul 18, 2019, at 02:19, Sandy Ginoza wrote:
>>> Hi all,
>>> 
>>> As you know, the transition to XMLv3 is quickly approaching.  As part 
>>> of our preparation, the RPC is  converting some XMLv2 files to XMLv3.  
>>> We’re hoping some of you will take the time to review the files and 
>>> provide feedback regarding whether the updates are as expected and the 
>>> XMLv3 files are considered “good” v3 files.  
>>> 
>>> A couple of notes:
>>> - we focused on format only; we did not make editorial updates. 
>>> - the diff files compare the initial v2v3 output with the files we edited.
>>> 
>>> Please review the following files:
>>> 
>>> 1) draft-ietf-spring-segment-routing-msdc
>>> https://www.ietf.org/id/draft-ietf-spring-segment-routing-msdc-11.txt
>>> 
>>> https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3.html
>>> https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3.pdf
>>> https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3.txt
>>> https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3.xml
>>> 
>>> rfc-xmldiff:
>>> https://www.rfc-editor.org/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3-xmldiff.html
>>> 
>>> htmlwdiff:
>>> file:///Volumes/rfcpa/inc-work/v3test/draft-ietf-spring-segment-routing-msdc-11-MS.v2v3-htmlwdiff.html
>>> 
>>> 
>>> 2) draft-ietf-isis-l2bundles
>>> https://www.ietf.org/id/draft-ietf-isis-l2bundles-07.txt
>>> 
>>> Please pay particular attention to lists and the use of <aside>.  We 
>>> experimented with list styles and used <aside> for notes.  Using 
>>> <aside> in this way required some changes because <aside> can’t be used 
>>> within lists.  
>>> 
>>> https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.v2v3.html
>>> https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.v2v3.pdf
>>> https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.v2v3.txt
>>> https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.v2v3.xml
>>> 
>>> rfc-xmldiff:
>>> https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.orignal.v2v3-xmldiff.html
>>> 
>>> htmlwdiff:
>>> https://www.rfc-editor.org/v3test/draft-ietf-isis-l2bundles-07-SG.orignal.v2v3-htmlwdiff.html
>>> 
>>> 
>>> Thanks for your help!
>>> Sandy
>>> 
>>> _______________________________________________
>>> xml2rfc-dev mailing list
>>> [e-mail]
>>> https://www.ietf.org/mailman/listinfo/xml2rfc-dev
>>> 
> 
> _______________________________________________
> xml2rfc-dev mailing list
> [e-mail]
> https://www.ietf.org/mailman/listinfo/xml2rfc-dev