TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:RE: Réf. : A Theory at the End of the Rainbow? From:Niki Dow <NikiDow -at- RINGWOOD -dot- COM> Date:Fri, 20 Nov 1998 09:29:53 -0000
Another really excellent method of structured writing is DocuTools
(http://www.ptaonline.com) which concentrates on performance-based
user-focused documentation (using the same chunking principles etc.), and in
contrast, I find that I don't have to force myself to use the method at
all - it actually makes my life easier being able to totally concentrate on
document purpose and audience needs.
Niki
> -----Original Message-----
> From: Technical Writers List; for all Technical Communication issues
> [mailto:TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU]On Behalf Of Mark Craig
> Sent: 19 November 1998 17:17
> To: TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU
> Subject: Réf. : A Theory at the End of the Rainbow?
>
>
> Information Mapping (http://www.infomap.com/) is another "chunking and
> analyzing the needs of the user" method, which I know better than Clustar
> (http://www.simplywritten.com/clustx.htm). It works great for task-based
> documentation. The really hard part is forcing yourself to use the method.
>
> However, when you're trying to get the user to catch on rather
> than perform
> tasks (as in programmer's guides), you need something less specifically
> task-based. A good, thin book to start you thinking is "The
> presentation of
> technical information" by Reginald O'Kapp
> (http://www.amazon.com/exec/obidos/ASIN/0094590702/qid%3D911494830
> /002-3730
> 706-4994409). It was recently reprinted by the ISTC
> (http://www.istc.org.uk/) though I have no idea whether that printing has
> sold out or not. It has helped me pull back and get a better look at the
> big picture as I do documentation for an SDK.
>
> Very interesting thread.
>
>
> ==================================================================
> =========
>
>
>
>