-
Notifications
You must be signed in to change notification settings - Fork 95
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
FAQ appendix cleanup #733
FAQ appendix cleanup #733
Conversation
Trim down wording, remove FAQ style headers, make use of 'refers to' instead of 'identifies' consistent.
…ID subjects, not the DID doc itself
Thanks @rhiaro,
|
Thanks @iherman. I meant to note about the main heading - I definitely wasn't sure about Implementation Guidance, and was looking for feedback on that. I thought appendices were non-normative by definition, but I can add that explicitly if necessary. If |
index.html
Outdated
@@ -5987,99 +5990,78 @@ <h2>application/did+cbor</h2> | |||
</section> | |||
|
|||
<section class="appendix"> | |||
<h1>Frequently Asked Questions about DID Identification</h1> | |||
<h1>Implementation Guidance</h1> |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Perhaps this could be
<h1>Implementation Guidance</h1> | |
<h1>Appendix</h1> |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We have multiple appendices... If we took this change, the spec would read: "Appendix C: Appendix"... which might not be the most helpful title. :P
Editorial, multiple positive reviews, no objections, merging. |
For #728
Removed FAQ style headings and responses, trimmed down some text, made some language consistent.
Note - one subsection said DID docs can be used to serve representations of resources, like schemas. I thought the group had resolved that DID docs should have minimal stuff for the specific needs of DIDs, and that any more than this was bad practice (per the
resource=true
discussion) so I've updated it to say to use a DID parameter to do this but didn't mention theresource
parameter as it still doesn't have a spec linked in the Registries. This is a separate commit though so can revert if I got the wrong end of the stick.Also added a paragraph aiming to address #718 about whether the DID subject can change.
Preview | Diff