search

w3c / did-core

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

Adding a detailed overview diagram to appendix #600

Closed shigeya closed 3 years ago

shigeya commented 3 years ago

Experimental Keeping old figure for review.

Related to #453. Trying to include all of the relationships of the entities described in 1.3. Architecture Overview.

This diagram does not display DID methods, DID resolvers, and DID URL dereferences in this picture since their position in this level of abstraction is unclear.

Preview | Diff

shigeya commented 3 years ago

Note that we need consistency of notation/expression/sizes/whatever among the figures. I believe I can update figures as part of editorial fixes. So, I let the color black and white for now.

shigeya commented 3 years ago

This diagram does not display DID methods, DID resolvers, and DID URL dereferences in this picture since their position in this level of abstraction is unclear.

I tried to place them into the figure. Texts are smaller than I want, but now every component described in the section is in the diagram.

shigeya commented 3 years ago

The preview link above doesn't work. For the review, I added the following PNG here.

did_architecture_overview-2

shigeya commented 3 years ago

Minor fix

did_architecture_overview-2

shigeya commented 3 years ago

Minor update to add self-reference dereference to DID Document. did_architecture_overview-2

shigeya commented 3 years ago

PR includes the SVG file for the above figure. This time, I also committed the corresponding PNG file too.

shigeya commented 3 years ago

Clean-up of the PR. Also fixed the text DID document-local to DID document-relative. did_architecture_overview-2

shigeya commented 3 years ago

Two issues on the figure

  1. It's correctly drawn with Safari but not with Firefox(85.0) and Chrome(88), as attached image (properties inside the DID document box): ScreenShot 2021-02-08 17 18 45
  2. Probably need to draw a relationship between DID resolver and DID dereferencer.
shigeya commented 3 years ago

Fixed the compatibility issue mentioned above.

shigeya commented 3 years ago

@msporny I understand your concern and I fully agree with you. Let me try to create a simpler diagram based on this in 13 hours (It's about 11 am in AoE clock: https://time.is/Anywhere_on_Earth).

shigeya commented 3 years ago

A brief version of the above is created and sent as another PR #612. I will update this PR to relocate the diagram to the appendix section.

shigeya commented 3 years ago

Relocated to the appendix, prior to FAQ. Attached the image for the convenience of the review.

To make use of the rich real estate of the appendix section, adjusted the diagram to be narrower, taller. Adjusted to use larger font size and little extra spaces between texts, boxes, and lines.

Plus, some minor clean-ups including "did:" to be text, not in a box, etc. did_detailed_architecture_overview

msporny commented 3 years ago

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