Re: bikeshed and merged docs

On 3/14/16, 10:35 PM, "Dirk Balfanz" <balfanz@google.com<mailto:balfanz@google.com>> wrote:
I converted the remaining two docs (signature-format and key-attestation) to bikeshed format, and then merged (basically concatenated) the three docs into one.

It's in a branch 'doc-merge' (https://github.com/w3c/webauthn/tree/doc-merge), and it works like this:

- index.src.html: the combined bikeshed source for all three docs
- biblio.json: the bibliography
- Makefile: the Makefile that shows how to invoke bikeshed

- index.html: the bikeshed output.

I haven't removed the three sources in webauth-key-attestation, webauthn-signature-format, and webauthn-web-api yet (even in that branch), so people can check out the branch, run diffs etc., to see what I did.

bikeshed (at least the version I have) runs without warnings/errors on this, but that doesn't mean that currently all the cross-references are well-formed. Let me know if this looks good to people. If so, I'll nuke the three old subdirectories (webauth-key-attestation, webauthn-signature-format, and webauthn-web-api) and pull this into master, at which point the hard work of polishing this can begin.

https://github.com/w3c/webauthn/blob/doc-merge/index.src.html looks good to me upon somewhat cursory inspection -- i note that you moved some sections around, but I did not note any missing sections once I'd grovelled around from end2end :)

thanks again!

=JeffH