| |||||||||||||
Building a narrative to tell a story ...Building a narrative to tell a story ...Posted Aug 12, 2011 20:27 UTC (Fri) by lowlymortal (guest, #78175)Parent article: Meet the Lockers
This article reminds of my (failed) attempt at one company to re-structure
technical documents as a narrative that had history/background and context (i.e. why?), in addition to what needs be accomplished. There is a reason folk-lores survive much longer than other forms of historical vehicles. ;) There is always a story behind everything ....
(Log in to post comments)
Building a narrative to tell a story ... Posted Aug 12, 2011 23:30 UTC (Fri) by neilbrown (subscriber, #359) [Link]
Interesting idea. I don't think it would work for reference documents, but for tutorial/introductory/background documents it sounds perfect. Making it into an story would encourage the reader to read all the way to the end, and might help them remember and understand.
I wonder how many technical writers have English Literature degrees :-)
Building a narrative to tell a story ... Posted Aug 13, 2011 0:02 UTC (Sat) by corbet (editor, #1) [Link] It's been done in other settings - look at Knuth's literate programming stuff as a great example. Then, there's Rusty's lguest documentation, which provides a story in a way that only Rusty can do...
|
|||||||||||||