edits and comments on draft f1ecec5

[jspaaks]

Hey folks! Thanks for the great work so far. As I was going through the document, I realized I was perhaps a bit too early but I decided to send you my comments and edits anyway in hopes they would still be helpful. Feel free to accept / decline / edit as you see fit.

I have used HTML comments <!-- and --> to make comments in the source, so reviewers can use their machine-local tooling if they want. Note that these do end up in the rendered document, although browsers know not to show them.

Best regards,
Jurriaan

[welcome]

Thanks for opening this pull request! Please don't forget to add your information to _metadata.yml.

[arokem]

Hi @jspaaks : thanks for your contributions and apologies for the slowness. Would you mind adding your author metadata in the _metadata.yml file?

[jspaaks]

Hi,

Thanks all for your work on this document. I just resolved conflicts after some time away from it (apologies for the delay), which left nothing to merge :) so I'll just close this PR.

As to the request above, it's good like it is now AFAIC.