RE: Narrative Technical Writing

Subject: RE: Narrative Technical Writing
From: "Mike McCallister" <mike -dot- mccallister -at- pkware -dot- com>
To: "Janoff, Steve" <Steve -dot- Janoff2 -at- Teradata -dot- com>
Date: Tue, 3 Nov 2009 16:41:00 -0600


Yes, they are definitely enthusiasts and developers, but I've been
reading the Lifehacker blog (which these folks write) for years and
haven't found the writing too dense. But I haven't scanned this text yet
beyond a quick read of the first chapter.

I do think that Wave *could* really help in documentation reviews,
though. Throw the text into a Wave, and it doesn't matter that the SMEs
don't have FrameMaker/Acrobat Pro. But that is for another thread...


Mike McCallister
Document Architect
PKWARE, Inc.

-----Original Message-----
From: Janoff, Steve [mailto:Steve -dot- Janoff2 -at- Teradata -dot- com]
Sent: Tuesday, November 03, 2009 3:53 PM
To: Mike McCallister; voxwoman; Robert Lauriston
Cc: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: RE: Narrative Technical Writing

Wow. Thanks for sending this on, Mike. Will be interesting to scan, at
least.

This seems to have been written by enthusiasts/developers rather than
tech writers.

Looks like there's going to be a need for tech writers for a
LOOOOOOOONNNNNNNNNNNNNNGGGGGGGGGGGGGGG time, judging by this. :)

Man, I don't know about you, but I would just *dread* confronting a
manual like this. I sort of get the feeling that the product is
exciting but you kind of can't tell it from this doc.

Where's the minimalist version? :)

Steve

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Are you looking for one documentation tool that does it all? Author,
build, test, and publish your Help files with just one easy-to-use tool.
Try the latest Doc-To-Help 2009 v3 risk-free for 30-days at:
http://www.doctohelp.com/

Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.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-unsubscribe -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.techwr-l.com/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


References:
Re: Narrative Technical Writing: From: Chris Despopoulos
RE: Narrative Technical Writing: From: Janoff, Steve
Re: Narrative Technical Writing: From: Robert Lauriston
Re: Narrative Technical Writing: From: voxwoman
RE: Narrative Technical Writing: From: Mike McCallister
RE: Narrative Technical Writing: From: Janoff, Steve

Previous by Author: RE: Narrative Technical Writing
Next by Author: Re: Editable List of Filenames from Windows?
Previous by Thread: RE: Narrative Technical Writing
Next by Thread: RE: Narrative Technical Writing


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

Sponsored Ads


Sponsored Ads