Topic Writing and Editing?

Subject: Topic Writing and Editing?
From: Geoff Hart <ghart -at- videotron -dot- ca>
To: TECHWR-L' Whirlers <techwr-l -at- lists -dot- techwr-l -dot- com>, Kent Drummond <kent -dot- drummond -at- sbcglobal -dot- net>
Date: Sun, 17 Aug 2008 09:37:45 -0400

Kent Drummond wondered: <<Interviewed for a position in a group
responsible for software documentation using Topics. Will someone
please direct me to some source information on topic writing
guidelines.>>

If you want more specific help, please provide details: do you mean
DITA or DocBook topics, or just a more general guideline to creating
a chunk of information that focuses on a single topic? I don't know
enough about the two former topics, but there are many experts here
who do.

For a couple general suggestions related to the latter:
http://www.geoff-hart.com/resources/2007/complete.htm
http://www.geoff-hart.com/resources/2006/outlining.htm

----------------------------------------------------
-- Geoff Hart
ghart -at- videotron -dot- ca / geoffhart -at- mac -dot- com
www.geoff-hart.com
--------------------------------------------------
***Now available*** _Effective onscreen editing_
(http://www.geoff-hart.com/home/onscreen-book.htm)

Print version: http://stores.lulu.com/store.php?fStoreID=1505747

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

ComponentOne Doc-To-Help gives you everything you need to author and
publish quality Help, Web, and print content. Perfect for technical
authors, developers, and policy writers. Download a FREE trial.
http://www.componentone.com/DocToHelp/

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! 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.


Follow-Ups:

References:
Topic Writing and Editing: From: Kent Drummond

Previous by Author: Value added (or lost) by technical communication? (Take II)
Next by Author: One or two LCD Monitors?
Previous by Thread: [Forwarding Kristen's reply to] Topic Writing and Editing
Next by Thread: Resources about topic-based authoring (Was "Re: Topic Writing and Editing?")


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


Sponsored Ads