Skip to content
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

Closed
mwherman2000 opened this issue Jan 19, 2019 · 2 comments
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

Comments

@mwherman2000
Copy link

mwherman2000 commented Jan 19, 2019

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,

  1. 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?

  2. 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:

@mwherman2000 mwherman2000 changed the title [Introduction] Draft DID spec has no stated Purpose nor defines the Target Audience for the document... [Introduction] Is the Purpose of the Draft DID spec clear and correct? Is there a defined Target Audience for the document... Jan 19, 2019
@mwherman2000
Copy link
Author

The https://w3c-ccg.github.io/did-spec/#purpose-of-this-specification section should be moved up closer to the beginning of the document.

@jandrieu
Copy link
Contributor

Closing as I believe the refactor in PR #164 addresses this issue. If not, please raise a new issue in the DIDWG did-spec repo.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
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
Projects
None yet
Development

No branches or pull requests

3 participants