- From: Michael Herman (Trusted Digital Web) <mwherman@parallelspace.net>
- Date: Tue, 24 Aug 2021 21:53:31 +0000
- To: Steve Capell <steve.capell@gmail.com>
- CC: Ted Thibodeau Jr <tthibodeau@openlinksw.com>, "public-credentials@w3.org" <public-credentials@w3.org>
- Message-ID: <MWHPR1301MB2094FF5C8C6F2DE6E708F756C3C59@MWHPR1301MB2094.namprd13.prod.outlook.>
RE: Would the intended audience be… Jeepers 😊, I think you’re asking what I imagined might be the most contentious question right off the top …let’s get the discussions underway... Here’s the specific intended audience statement I was going to propose. It’s one I use for the audiences I tend to focus on. Intended Audience The intended audience for the Verified Credentials Guide is a broad range of professionals interested in furthering the application of Verifiable Credentials technology for use in software apps, agents, and services. The primary audience includes software architects, application developers, and user experience (UX) specialists; as well as people involved in a broad range of standards efforts related to decentralized identity, verified credentials, and secure storage. Michael Herman From: Steve Capell <steve.capell@gmail.com> Sent: August 24, 2021 3:43 PM To: Michael Herman (Trusted Digital Web) <mwherman@parallelspace.net> Cc: Ted Thibodeau Jr <tthibodeau@openlinksw.com>; public-credentials@w3.org Subject: Re: What are VCs similar to? Would the intended audience be: - technical people new to the domain that need some high level architecture overview and navigation framework into the more detailed specifications (including all the ccg documents)? Or - business / policy people who need a layman’s overview and business case for investment so that they have the backing to fund projects? Or Some other audience? Steven Capell Mob: 0410 437854 On 25 Aug 2021, at 7:36 am, Michael Herman (Trusted Digital Web) <mwherman@parallelspace.net<mailto:mwherman@parallelspace.net>> wrote: Thank you Ted, I greatly appreciate the concrete examples of W3C Primers. What I'm initially going to propose is a much simpler style of document that, if the community chooses, might later evolve into a Primer. The concept I have in mind I'm referring to as a Guide, with the working title being the Verifiable Credentials Guide (actual title subject to eventual discussion once the work item is ready for review). The high-level goal is to knit together, by reference, the 3 documents we currently have in the VC family with some framing such as: * Background * Overview * Purpose * Intended Audience * Goals * Drivers * Organization of the VC Documents * A section per existing document with a single paragraph or two about each of the existing VC documents in terms of what they contain * A final section about how they inter-relate, where to go for what Body text of maybe 5 pages in length (I would be personally disappointed if it was much longer than 5 pages). Oops 😉 I didn’t mean to but I guess the above is the draft of the core language in the W3C Note work item to be proposed, maybe later this week. A follow-on CCG work item might propose that an actual Primer be created (as referenced by Ted’s excellent list of examples) but I have a strong preference that we start with the Guide concept because I think it can be completed fairly quickly, without too much contention, and still provide significant value – particular for the audience I have in mind (possibly in the 1.1/1.2 timeframe without impacting the 1.1/1.2 schedule …or with very minimal impact). Like yourself Ted, I’m bringing forward my knowledge and experience as a software architect, professional communicator, and awarding-winning technical writer. I want to do this in a collegial way to benefit the VC community at large. Lastly, I need a co-author. Who would like to work on this work item as a co-author (is editor the more correct term?). Thoughts? Michael Herman -----Original Message----- From: Ted Thibodeau Jr <tthibodeau@openlinksw.com<mailto:tthibodeau@openlinksw.com>> Sent: August 24, 2021 2:03 PM To: Michael Herman (Trusted Digital Web) <mwherman@parallelspace.net<mailto:mwherman@parallelspace.net>> Cc: public-credentials@w3.org<mailto:public-credentials@w3.org> Subject: Re: What are VCs similar to? On Aug 24, 2021, at 09:16 AM, Michael Herman (Trusted Digital Web) <mwherman@parallelspace.net<mailto:mwherman@parallelspace.net>> wrote: > > [last attempt :-) ] > What I’m looking for is a set of existing specs that we can use as a model for how to structure our VC specification documents (which are not a single spec doc but rather a family of recommendations and notes). > > Thoughts? > > Michael 1. All -- Note how I've trimmed all the excess from this message. (Also note, I do not include a logo in my email, especially not when sending to a large population such as this mailing list.) Please consider conserving the spinning rust that stores these messages, not to mention the sometimes limited bandwidth of the pipes through which they must travel, and do similarly in all replies. 2. Michael, I believe what you're looking for is what folks in W3 groups have long referred to as a PRIMER. Examples include the PROV-O Primer [1], the RDF 1.1 Primer [2], and many more [3]. Contributions to such a primer for DIDs, VCs, and related arenas would be welcome, I'm sure, though I should caution all potential contributors that those contributions may be edited rather a lot by the end of the process, and you may not recognize what you have contributed in the final product -- but that does not mean that your contributions are not valuable and helpful along the way! Every little bit helps! Be seeing you, Ted [1] https://www.w3.org/TR/prov-primer/ [2] https://www.w3.org/TR/rdf11-primer/ [3] https://www.google.com/search?q=site%3Aw3.org+inurl%3Atr+primer -- A: Yes. http://www.idallen.com/topposting.html | Q: Are you sure? | | A: Because it reverses the logical flow of conversation. | | | Q: Why is top posting frowned upon? Ted Thibodeau, Jr. // voice +1-781-273-0900 x32 Senior Support & Evangelism // mailto:tthibodeau@openlinksw.com // http://twitter.com/TallTed OpenLink Software, Inc. // http://www.openlinksw.com/ 20 Burlington Mall Road, Suite 322, Burlington MA 01803 Weblog -- http://www.openlinksw.com/blogs/ Community -- https://community.openlinksw.com/ LinkedIn -- http://www.linkedin.com/company/openlink-software/ Twitter -- http://twitter.com/OpenLink Facebook -- http://www.facebook.com/OpenLinkSoftware Universal Data Access, Integration, and Management Technology Providers
Received on Tuesday, 24 August 2021 21:53:49 UTC