search

decentralized-identity / trust-establishment

https://identity.foundation/trust-establishment
https://identity.foundation/trust-establishment/
Apache License 2.0
10 stars 5 forks source link

Prepare directory structure for V1 #38

Closed decentralgabe closed 1 year ago

dtmcg commented 1 year ago

do you want to keep a working copy under spec/spec.md?

decentralgabe commented 1 year ago

do you want to keep a working copy under spec/spec.md?

don't think so - can just create a new version folder for changes

bumblefudge commented 1 year ago

Some thoughts, each of which I'd recommend converting to new issues for addressing post v1 unless they have easy answers or can be addressed by quick edits:

  1. why author and not, say, controller?
  2. I took a kind of contrarian, sassy stab at the "todo" to define trust topics, please iterate if it's too sassy or judgmental. Spec is a little cryptic without a little more explanation of its use-case and mental model!
  3. The Topic Registry TODO I think should be done before v1. Since topics are defined as URIs of schemas, you could just point to schema-directory or something equivalent at, say, TOIP?
    3B. Sidenote: the schema directory doesn't really look like the other DIF registries, maybe we can give that group a nudge to make something more... presentable? It feels like another case of the "v1 can't be cut if it depends on a v0 spec or registry" problem that has plagued this WG since time immemorial 😉
bumblefudge commented 1 year ago

also note image

decentralgabe commented 1 year ago

Thanks @bumblefudge for the review.

I opened up https://github.com/decentralized-identity/schema-directory/issues/5 on the Schema Directory repo.

I've added spec text around Trust Topics that I hope addresses your feedback.

I wonder about the semantic different between author and controller. I believe author implies controller -- or at least that is my intention, though I'm not sure the inverse is true. The intent was to establish who created the document.

Got rid of those TODOs. Let me know what you think.