Re: [webauthn] MDN panels do not appear in editors' draft (#1414)

> I'm not sure if the bikeshed cache local to this repo is still being used to generate the spec, but maybe it is what interfering with the build?

Yes, that was the problem. The Travis CI build that publishes the spec to the `gh-pages` branch and thus to https://w3c.github.io/webauthn/ doesn’t use up-to-date data files that Bikeshed normally relies on but instead uses copies that are under version control in the `.spec-data` and `.bikeshed-include` directories of this repo.

Those copies were over 2 years out of date, so I took the liberty of updating them and pushing the update to the master branch. So https://w3c.github.io/webauthn/ now has MDN annotations.

As far as that mechanism to keep copies of the Bikeshed data files under version control in the repo: I don’t understand what the rationale was for it setting up to begin with — so to prevent another problem in the future like the one described in this issue, I’d personally recommend that those copies be removed from the repo and that the `.travis.yml` file in the repo be changed to stop relying on those copies and instead use the data files that Bikeshed would otherwise be using.

But if the editors don’t want to change that setup for the time being, then somebody needs to take responsibility for periodically doing this:
 ```
./update-bikeshed-cache.sh && git add .spec-data .bikeshed-include && git commit .
```
The `README.md` in the repo already provides how-to steps on doing that. And there was one minor problem with a message the `update-bikeshed-cache.sh` script emits, but #1427 has a fix for that.

So, going forward, if the steps currently documented in the `README.md` file are followed, everything that’s already set up for this repo should work as expected — and future problems like the one described in this issue will be avoided.

-- 
GitHub Notification of comment by sideshowbarker
Please view or discuss this issue at https://github.com/w3c/webauthn/issues/1414#issuecomment-635257311 using your GitHub account

Received on Thursday, 28 May 2020 10:29:04 UTC