did-imp-guide icon indicating copy to clipboard operation
did-imp-guide copied to clipboard

Do an editorial pass

Open OR13 opened this issue 4 years ago • 3 comments

  • [ ] Wrap terms in a tag, such as DID and DID Document (https://github.com/w3c/did-imp-guide/pull/12#discussion_r686214151)

  • [ ] Remove parens (https://github.com/w3c/did-imp-guide/pull/12#discussion_r686216993)

  • [ ] Title case all H2's (https://github.com/w3c/did-imp-guide/pull/12#discussion_r686215692)

  • [ ] Remove (may) (https://github.com/w3c/did-imp-guide/pull/12#discussion_r686217739)

  • [ ] Gramar (https://github.com/w3c/did-imp-guide/pull/12#discussion_r686218516)

  • [ ] Remove SHOULD (https://github.com/w3c/did-imp-guide/pull/12#discussion_r686221877)

  • [ ] Adjust headings "Drawback and Benefits" (https://github.com/w3c/did-imp-guide/pull/12#pullrequestreview-726851046)

  • [ ] use <a data-cite="INFRA#strings">string</a>

OR13 avatar Aug 10 '21 20:08 OR13

Here are the respec docs: https://respec.org/docs/

msporny avatar Aug 12 '21 14:08 msporny

sugggestion to call both Drawbacks and Benefits "Benefits".

OR13 avatar Aug 12 '21 14:08 OR13

Examples of data-cite (which you will need to do to link to terms outside of the spec): https://github.com/w3c/did-core/blob/main/index.html#L190 and https://github.com/w3c/did-core/blob/main/index.html#L764

msporny avatar Aug 12 '21 14:08 msporny