mark sections normative; move algorithms

[decentralgabe]

fix #300

• mark sections as normative, informative
• move algorithms above non-normative section
• combined verification and validation sections under a common 'algorithms' section

---

Preview | Diff

[selfissued]

Where can I view the rendered version of this PR? The usual "Preview" link isn't in evidence.

[iherman]

There seems to be some problem with the background processing that I could not track down. I believe it may be with the "spec generator". That is probably the reason why preview does not appear either.

The (complicated) way around that I found is as follows:

• download the new branch onto the local clone of repository and ask git to make this your current branch
• two possibilities:
  • if you run a local http server which has access to the repository, then view the index.html file in your browser via localhost
  • otherwise, go to https://labs.w3.org/spec-generator/ and upload the source code there

In theory, one could use the spec generator using https://htmlpreview.github.io/?https://github.com/w3c/vc-jose-cose/blob/fix-300/index.html to render the file, but it returns a (I believe unjustified) but report.

cc @deniak ?

[deniak]

As far as I can tell, spec-generator can process that document just fine, see https://labs.w3.org/spec-generator/?type=respec&url=https%3A%2F%2Fraw.githubusercontent.com%2Fw3c%2Fvc-jose-cose%2Fdcfe55993ade74facbd7d39d755e3a89dacefd66%2Findex.html&file=
@tobie, any idea why pr-preview isn't adding the links on that PR? The other PRs seem to work ok.

[iherman]

Hm. Maybe it is a problem with htmlpreview (I must admit I have never used this raw.githubusercontent.com trick).

[selfissued]

Please delete all instances of class="normative". I verified that it doesn't change the output for normative sections, so it's just unnecessary clutter in the source, given that sections are normative by default.

[tobie]

@tobie, any idea why pr-preview isn't adding the links on that PR? The other PRs seem to work ok.

Not sure what the issue was here. Seems fixed now. LMK if this happens again.

[decentralgabe]

Opened over a week. Changes addressed. Editorial approval. Merging.