- From: Liam R. E. Quin <liam@fromoldbooks.org>
- Date: Wed, 10 Oct 2018 12:51:30 -0400
- To: Andrew Hughes <andrewhughes3000@gmail.com>, "W3C Credentials CG (Public List)" <public-credentials@w3.org>
On Tue, 2018-10-09 at 09:54 -0700, Andrew Hughes wrote: > As discussed on the ccg call today - I'd like to conduct a > collaborative working session this week to develop a concept map for > DIDs, based on the text of the DID Primer and DID Spec. Sorry to be crawling out of the woodwork a bit here :) In the past i've advised WGs to avoid writing primers, and instead to put what they were going to put into a primer into their main spec, e.g. having an introductory section for each main chapter of the spec. There are two reasons for this - the first is that having a primer can make people tihnk the base spec is more complex than it really is. The second is that there can be a risk that people say, when developing a spec, "oh, we don't need to explain that, we'll put it in the primer", and the spec suffers as a result. It might be that neither of these applies here (although I suspect the first does at least), and having tutorials, 'getting started guides" and so on around a technology is all pretty essential. Best, Liam -- Liam Quin, https://www.holoweb.net/liam/cv/ Web slave for vintage clipart http://www.fromoldbooks.org/ Available for XML/Document/Information Architecture/ XSL/XQuery/Web/Text Processing/A11Y work, training, consulting.
Received on Wednesday, 10 October 2018 16:52:14 UTC