W3C home > Mailing lists > Public > public-credentials@w3.org > June 2016

Re: Suggestion: use simple time-flow example as Architecture Block Diagram

From: Steven Rowat <steven_rowat@sunshine.net>
Date: Tue, 14 Jun 2016 07:38:31 -0700
To: Eric Korb <eric.korb@truecred.com>
Cc: Credentials CG <public-credentials@w3.org>
Message-ID: <514e7582-7847-db5b-a010-1c7d4b14c426@sunshine.net>
On 6/14/16 4:54 AM, Eric Korb wrote:
> I find Dave Longley's diagram to be adequate and represents the flow
> that we've been discussing.  I'm looking forward to seeing Steven's as
> well.

Based on the fast and furious exchanges in four different threads this 
morning, I've learned at least two and possibly three new things that 
would affect how I would build that diagram, though they haven't 
affected the core way I imagined it. And I originally had three 
different versions in mind that I wanted to experiment with, differing 
slightly in graphic approach -- so I'm not going to even start until 
this dies down and I better understand these new details.

But I remain convinced that a 'one big picture' graphic is worth doing 
here. The complexity of this VC data overall architecture -- which 
involves several time-steps among several types of entities and 
documents, and fine differences in definition -- combined with the 
importance of the work as a whole, make an attempt worthwhile I think, 
although it may take several iterations of feedback to get it right. 
But perhaps after that it would allow new people easier access to how 
the system is supposed to work.


> Eric
> ------------------------------------------------------------------------
> TrueCred™ | Digital Credential Trust™
> ------------------------------------------------------------------------
> On Mon, Jun 13, 2016 at 3:30 PM, Dave Longley
> <dlongley@digitalbazaar.com <mailto:dlongley@digitalbazaar.com>> wrote:
>     On 06/13/2016 12:52 PM, Steven Rowat wrote:
>         On 6/13/16 9:19 AM, Dave Longley wrote:
>             On 06/12/2016 07:55 PM, Steven Rowat wrote:
>                 On 6/12/16 8:04 AM, msporny@digitalbazaar.com
>                 <mailto:msporny@digitalbazaar.com> wrote:
>                     Topic: Discuss purpose of architecture proposal
>                     Adam Lake:
>                     http://w3c.github.io/webpayments-ig/VCTF/architecture/
>                     Adam Lake: Long form version,
>                     https://github.com/WebOfTrustInfo/ID2020DesignWorkshop/raw/master/topics-and-advance-readings/a-self-sovereign-identity-architecture.pdf
>                     Manu Sporny:  We're putting this proposal together
>                     because a
>                       number of people at W3C requested it. This arch
>                     doc is here to
>                       quickly inform people about the type of arch
>                     we're talking about.
>                 I'd like to suggest a change of the basic architecture
>                 'block diagram'.
>                 I believe it will be easier to follow, and be more
>                 meaningful to a new
>                 reader, if it is presented as a 'flow diagram' that
>                 includes time.
>                 I suggest as an example of what I mean, that steps
>                 like the ones below,
>                 for a simple Credential creation and check, could be
>                 blocks, possibly
>                 set up left-to- right or top-to-bottom for the flow of
>                 time:
>             Here's another take on the diagram. This may not be quite
>             what you're
>             asking for -- but please provide feedback:
>             https://docs.google.com/drawings/d/1M2cfMOCbXmMhg8Ar2YeCiRhMsJK-hzkCf1L_hJKMOHY/edit?usp=sharing
>         Dave,
>         Thanks for doing this. I'll note off the top that I woke up
>         last night
>         at 3 a.m. and had a vision of what the diagram could look
>         like, with all
>         the time-flow steps and taking into account the Entities (real and
>         virtual) of: Subject, Holder, Issuer, Repository, and Relaying
>         Party,
>         and the Documents (fixed statements) of Claim and Credential.
>         This took half an hour to take shape in my mind, and then I
>         dictated a
>         description of it. I'm committed to making my imagined version
>         of the
>         diagram myself (I've done a lot of computer technical drawing
>         in my
>         life, but none for several years, and would enjoy the
>         challenge at this
>         point.)
>         About yours: it's nothing like mine at all. :-)
>         Although technically interesting to have the diagram change
>         and show
>         steps in sequence like that, with due respect, I found it just as
>         confusing. And I don't know if it's wise to introduce that
>         technology
>         anyway for a mission-critical diagram -- it may not work for
>         some people.
>         If I may, I'll make mine and send a link. Would a Drop-box
>         link work? Or
>         is sending as an attachment better?
>         And I can do any common graphic file format -- png, svg, jpg,
>         pdf, etc.
>         If you have a preference let me know.
>         I'm going to transcribe my last-night's dictation today and
>         probably
>         start making the diagram, but I might as well delay sending
>         until I get
>         the results of the voting for terminology, which I should use
>         in it.
>     No personal preferences on delivery, just want it to be accessible to
>     everyone interested. Feel free to use whatever terminology you want
>     (don't let poll results slow you down). Better to get the diagram out
>     there and get feedback.
>     --
>     Dave Longley
>     CTO
>     Digital Bazaar, Inc.
>     http://digitalbazaar.com
Received on Tuesday, 14 June 2016 14:38:56 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 11 July 2018 21:19:29 UTC