Re: Collaborate on a concept map for DIDs based on DID Primer

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