W3C home > Mailing lists > Public > public-webauthn@w3.org > August 2017

Re: editorial nit wrt publishing working draft

From: Wendy Seltzer <wseltzer@w3.org>
Date: Tue, 15 Aug 2017 14:59:00 -0400
To: Angelo Liao <huliao@microsoft.com>, W3C Web Authn WG <public-webauthn@w3.org>
Message-ID: <d275ce99-be50-17cc-0cbc-4c0e9fc4f7c8@w3.org>
Thanks Angelo!

On 08/14/2017 06:46 PM, Angelo Liao wrote:
> Thank you to Jeff for bringing up the topic of Bikeshed. Doing the below command really helps ensuring the spec stays in good shape and avoid cornercase linking errors. 
> 
> Specific to why the title isn't matching the editor's draft, the reason is I manually deleted the <br> elements in the title. This is because the PubRules (spec compliance checker) demands the title to match: https://www.w3.org/pubrules/doc/rules/?profile=WD#title. The new version of bikeshed would automatically add <br> element to the title string to make things fit. But doing so would not make the <h1> element match and therefore make PubRules unhappy. It's really a bug to be fixed in either bikeshed or Pubrules. But waiting for the bug to be fixed would take forever. I actually read bikeshed source code and sort of found a way to fix it? But my brain was tired to test the fix. 

If the fix is one that should go into Pubrules, I'll gladly poke people
on that repo, https://github.com/w3c/specberus

--Wendy

> 
> -----Original Message-----
> From: =JeffH [mailto:Jeff.Hodges@KingsMountain.com] 
> Sent: Monday, August 14, 2017 3:33 PM
> To: W3C Web Authn WG <public-webauthn@w3.org>
> Subject: editorial nit wrt publishing working draft
> 
> thanks again, Angelo, for "turning the crank" to get WD-06 published.
> 
> one nit I've noticed is that the formatting of the spec title in WD-06 does not match how it is working in the editor's draft, nor when using https://api.csswg.org/bikeshed/.
> 
> I am suspecting that this is due to a different (likely older?) version of bikeshed (BS) was used to produce the WD-06 spec than the latter two examples. If so, then when publishing working drafts we ought to ensure we're using the latest BS version. For locally-installed BS this is done as described here <https://tabatkins.github.io/bikeshed/#install-common>, which is (at this time):
> 
> ###
> To update bikeshed to its latest version at any time, just enter Bikeshed’s folder and run:
> 
> $ git pull --rebase
> $ bikeshed update
> 
> This’ll pull the latest version of Bikeshed, and ensure that you’re looking at the latest version of the data files, rather than whatever stale version is currently sitting in the repo.
> ###
> 
> HTH,
> 
> =JeffH
> 
> 


-- 
Wendy Seltzer -- wseltzer@w3.org +1.617.715.4883 (office)
Strategy Lead, World Wide Web Consortium (W3C)
https://wendy.seltzer.org/        +1.617.863.0613 (mobile)
Received on Tuesday, 15 August 2017 18:59:03 UTC

This archive was generated by hypermail 2.4.0 : Tuesday, 5 July 2022 07:26:26 UTC