New W3C publication requirements as of March 1

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|

New W3C publication requirements as of March 1

Philippe Le Hegaret
All,

We adopted back in May 2015  [1] a project to update our style sheets
used in W3C documents.

I'm pleased to report that, as of March 1st, the requirements for
publications will mandate the use of the new style sheets for all W3C
documents published on or after March 1st.

If you are currently using bikeshed or respec to generate your
specifications, you can safely ignore the rest of this message since
those tools will take care of the changes for you. Those tools will be
switched on March 1st to produce the expected requirements. As such, if
you would like to publish *on* March 1st, you can either use the
appropriate settings of the tool (such as the useExperimentalStyles
parameter in respec) or delay your publication until March 3. (see at
the bottom for requesting further help).

The new additional (or replaced) requirements are as follows:

-----------------------------------------------------------------------
1. You MUST use the following meta tag in your html/head:

<meta name="viewport" content="width=device-width, initial-scale=1,
shrink-to-fit=no">


2. The W3C style sheet is one of
   https://www.w3.org/StyleSheets/TR/2016/

  e.g.

  https://www.w3.org/StyleSheets/TR/2016/W3C-WD

3. You MUST use https://www.w3.org/StyleSheets/TR/2016/logos/W3C for the
W3C logo (instead of https://www.w3.org/Icons/w3c_home )


4. Your table of contents MUST be contained in a nav element with id=toc
   <nav id="toc"> must be wrapped around entire toc section (incl. heading)

    (use a div if you're still using HTML4 but we *strongly* advise you
to change to HTML5 in the upcoming months)

5. You MUST include the following script element at the of your html/body

   <script src="//www.w3.org/scripts/TR/2016/fixup.js"></script>
-----------------------------------------------------------------------


If you have questions or need help, please don't hesitate to follow up
on this message but don't wait for the day of your publication to
realize you need help please. A few of us are also on irc on the channel
#pub and you're welcome to seek help there as well.

Bug reports on the style sheets must be reported to
   https://github.com/w3c/tr-design/issues

We do expect Groups to need extra help during the switch and it may take
a few days to handle all requests, so I recommend that important timely
publication be done outside of the week of March 1st if possible.

Those style sheets requirements will remain in place until December
31st, 2016 and MAY get replaced after [2].

Thank you,

Philippe

[1] https://lists.w3.org/Archives/Public/spec-prod/2015AprJun/0018.html
[2] https://github.com/w3c/tr-design/blob/gh-pages/README.md