Directions for tomorrow's techwriting

Subject: Directions for tomorrow's techwriting
From: David Neeley <dbneeley -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 22 Apr 2002 08:24:53 -0700 (PDT)


Greetings!

I would appreciate your thoughts about the direction
of technical writing departments and practices in the
near future. Specifically, I invite your comments
about my growing conviction that we will see a growing
methodology shift driven by increased understanding of
the benefits of creating documentation that is easy to
re-use and maintain. It appears clear that this will
in most cases be through employment of XML and
repository tools based upon this technology.

I for one would welcome a shift away from the present
practice of having each technical writer spend a
substantial part of each day consumed with simple
formatting issues. This becomes such a burden that we
have discussion threads regarding "whether we should
clean up 'clunky English' after we have finished
formatting"-as if this were not a very basic part of
our jobs! (I would even assert that you cannot
properly format a document until and unless you have
it rendered into good English!)

Next, I find too many documents have distressingly
little time spent on fact-checking, completeness and
organization issues. Somewhere, writers must get the
time and the opportunity to polish the content of the
documents much more in the face of decreasing time
available.

Thus, I believe that in the most successful shops, the
bulk of writers may be best off using a basic XML
authoring tool that makes perhaps no more than ten to
fifteen tags easy to apply as you write-but without
any margins, headers and footers, etc.

As the documents are written properly, then, they
would be sent to a limited number of formatting
specialists who would transform the XML documents into
the output formats. Thus, there would be consistent
styles, better management of templates, and the
documents themselves would be far easier to maintain
in the future.

Does this sound reasonable to you? If not, why not?

Thanks for your opinions,

David Neeley

__________________________________________________
Do You Yahoo!?
Yahoo! Games - play chess, backgammon, pool and more
http://games.yahoo.com/


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Are you using Doc-to-Help or ForeHelp? Switch to RoboHelp for Word for $249
or to RoboHelp Office for only $499. Get the PC Magazine five-star rated
Help authoring tool for less! Go to http://www.ehelp.com/techwr

Free copy of ARTS PDF Tools when you register for the PDF
Conference by April 30. Leading-Edge Practices for Enterprise
& Government, June 3-5, Bethesda,MD. www.PDFConference.com

---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.


Follow-Ups:

Previous by Author: Re: PDFMaker error
Next by Author: Re: Font selection methodology
Previous by Thread: RE: Order of Magnitude
Next by Thread: Re: Directions for tomorrow's techwriting


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


Sponsored Ads