Name: webauthn
Owner: World Wide Web Consortium
Description: Web Authentication WG: https://www.w3.org/Webauthn Editors' Draft:
Created: 2016-02-08 14:51:38.0
Updated: 2018-01-11 23:15:26.0
Pushed: 2018-01-13 00:34:23.0
Homepage: https://w3c.github.io/webauthn/
Size: 9340
Language: HTML
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
This is the repository for the W3C WebAuthn Working Group, producing the draft “Web Authentication” specification.
gh-pages
branch of this repository.To materially contribute to this specification, you must meet the requirements outlined in CONTRIBUTING.md. Also, before submitting feedback, please familiarize yourself with our current issues list and review the mailing list discussion.
Formatted HTML for the draft can be built using bikeshed
(see below for instructions for bikeshed
installation):
keshed spec
You may also want to use the watch
functionality to automatically regenerate as you make changes:
keshed watch
You will need to have the Python tools pygments
and bikeshed
to build the draft. Pygments can be obtained via pip
, but Bikeshed will need to be downloaded with git
:
clone --depth=1 --branch=master https://github.com/tabatkins/bikeshed.git ./bikeshed
install pygments
install --editable ./bikeshed
R .spec-data/* ./bikeshed/bikeshed/spec-data
Alternatively, you can use the Vagrant VM with bikeshed
already installed.
This repository uses .deploy-output.sh
to generate the Editor's Draft on the gh-pages
branch upon every merge to master
. In order to prevent failed merges during continuous integration, the formatted Editor's Draft should not be checked in to master
, and it is in the .gitignore
file.
To build a new WD and upload it to the W3C publishing system:
shed update
shed spec
shed echidna --u USERNAME --p PASSWORD --d DECISION_URL
The command above will create a tarball of the HTML and images, and upload to Echidna, W3C's automated publishing system. The command should return a url, thhrough which you can know whether you successfully publish the draft. Status of the request can also be tracked through the Mailing List Archive. You can also use W3C API as described in the Echidna documentation. Note that on Windows, this will give an error about failing to delete a temporary file because it is in use by a different process. This error is harmless; it happens after the submission has completed.
If the publication through the process is unsuccessful, it's likely because of Specbreus, a spec compliance checker. Echidna automatically runs through Specbreus and will reject the publication if any error is reported by Specbreus. You can run your document through Pubrules to understand why your document is rejected. You may modify either the index.bs file or the index.html file to ensure compliance.
More often than not, you will discover the Pubrules errors are due to bugs in either Bikeshed or Specbreus. If so, you will have to modify the compiled index.html file to bypass Echidna and use the manual process to publish. While you are editing the html file to avoid errors, you should also check to ensure the document still renders correctly.
The manual process requires you to first create a tar file. To create the tar file, you need to first copy the index.html file and rename the copied file as Overview.html. This is because Echidna doesn't recognize index.html. You can then use the following command to create a tar file:
-cvf WD.tar Overview.html image1 image2 image3
Then you can run the following command curl to publish to Echidna (use the command at the same directory as your tar file):
'https://labs.w3.org/echidna/api/request' --user '<username>:<password>' -F "tar=@WD.tar" -F "decision=<decisionUrl>"
Feel free to contact your chair or any W3C staff when you are stucked. Overall info on echidna is here: https://github.com/w3c/echidna/wiki and here https://labs.w3.org/echidna/.