This repository has been archived by the owner on Oct 29, 2019. It is now read-only.
[Introduction] Is the Purpose of the Draft DID spec clear and correct? Is there a defined Target Audience for the document... #157
Labels
clarify
There is consensus, but the spec needs clarifying
intro/overview
Pertains to introductory sections of the spec, either main introduction or intros to subsections
Reference: https://w3c-ccg.github.io/did-spec/#purpose-of-this-specification
Draft DID spec issues roll-up: Decentralized Identifiers (DIDs) v0.11-Issues-mwh1.pdf
After reviewing each of the current open issues (see the above PDF file), I've realized that the Purpose for the draft DID spec is not clear and potentially, not correct or precise; nor does the document define the Primary Target Audience for the document. ...and I believe the document's content, focus, and precision suffers from the fact that these are not clear/missing.
For example,
Is the primary audience for the draft DID spec software people/builders? e.g. software architects and software developers? [I think so] ...application developers as well as platform maintainers?
Is the purpose of the draft DID spec to explain decentralized identifiers, DID Documents, etc. from the perspective of these being "lower level" technology layer concepts? ...software components/protocols? [I think so]
I think this issue needs to be addressed early on (e.g. first) before tackling the other issues listed in the PDF.
TODO: A specific PR stating a Purpose that is more complete/clear in the eyes of a stated Primary Target Audience is needed.
Cross-references:
The text was updated successfully, but these errors were encountered: