Re: the Hadoop comic

Subject: Re: the Hadoop comic
From: "Peter Neilson" <neilson -at- windstream -dot- net>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Thu, 29 Dec 2011 16:29:08 -0500

On Thu, 29 Dec 2011 15:56:19 -0500, Lee Fisher <blibbet -at- gmail -dot- com> wrote:

Maneesh's comic has been quite popular.

I've shown it to some people who didn't know about Hadoop before they read it, and the comic was quite effective at being teaching the topic. It would have been much more difficult to get them to learn about Hadoop, otherwise. :-)

Maybe all technical software products should ship with a comic. :-)

comic:
https://docs.google.com/open?id=0B-zw6KHOtbT4MmRkZWJjYzEtYjI3Ni00NTFjLWE0OGItYTU5OGMxYjc0N2M1

Astonishingly good.

1. Easy to follow. Not full of technical terms, and avoids passive voice. Visual presentation actually holds interest, unlike most PowerPoint presentations (yawwwn).

2. Carefully omits difficult points, at least until later.

3. Does not require highly skilled artist for creation. More like "Scott Adams" rather than "Hal Foster" but even Scott's style is beyond what is needed.

A few years ago the person named _why (or "why the lucky stiff") created comics for teaching Ruby. _why and his work was decidedly weird, but popular. Then one fine day (19 August 2009) he vanished. See http://en.wikipedia.org/wiki/Why_the_lucky_stiff

Gene Kim-Eng's comment (just received as I write this) suggests that this kind of style may not last more than one generation of documents. That's likely the case, especially if docs are eventually required to match a style specification. Comics are insufficiently vanilla.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


References:
the Hadoop comic: From: Lee Fisher

Previous by Author: Re: Effective planning for Help documentation: What can we learn from the user?
Next by Author: On reading instructions ...
Previous by Thread: Re: the Hadoop comic
Next by Thread: Re: the Hadoop comic


What this post helpful? Share it with friends and colleagues:

Sponsored Ads


Sponsored Ads