w3c / did-core

W3C Decentralized Identifier Specification v1.0
https://www.w3.org/TR/did-core/
Other
395 stars 93 forks source link

Add links to use cases document. Consolidate other useful links. #774

Closed msporny closed 2 years ago

msporny commented 2 years ago

I did it guys! I'm not completely inept. :P ...after 5 long years, the DID specification finally links to its use cases document.


Preview | Diff

msporny commented 2 years ago

Thanks very much for doing this @msporny, much appreciated. However, I'm going to be annoying and push for just a little more and, in doing so, hope to fix a small problem.

I suggest that the 4th paragraph of the introduction to the doc could be extended by a short sentence so that we have "... all without depending on a central authority to guarantee the continued existence of the identifier. These ideas are explored in the DID Use Cases document [[DID-USE-CASES]]."

This a) puts a link in the informative text rather then relying solely on the references section;

We already have a link in the informative text, that's what this PR does:

https://github.com/w3c/did-core/pull/774/files#diff-0eb547304658805aad788d320f10bf1f292797b5e6d745a3bf617584da017051R433-R437

I added your text as well, let me know if that's what you were going for?

b) uses SpecRef's database to insert the reference rather than the hand-edited link in the ReSpec config which, although it points to the correct URL, it uses author data from the CCG original.

Ah, yes, thank you and fixed in b6e0136f46e5fd3409769f94d06fa8cb8b98fd9a.

msporny commented 2 years ago

Editorial, multiple reviews, changes requested and made, no objections, merging.