RE: Documentation Tool in Linux Environment

Subject: RE: Documentation Tool in Linux Environment
From: "Chris Vickery" <cvickery -at- arenasolutions -dot- com>
To: "Dishaa" <dishaag -at- yahoo -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 9 May 2007 10:09:45 -0700

I recommend starting with DocBook or DITA. You can learn it in a
weekend. I am not a Rhodes scholar and I picked it up very quickly. Take
a one-time class, get the O'Reilly book, work with a consultant... any
or all of these steps would be worthwhile to allow you to start
single-sourcing.

Chris

-----Original Message-----
From: techwr-l-bounces+cvickery=arenasolutions -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+cvickery=arenasolutions -dot- com -at- lists -dot- techwr-l -dot- com]
On Behalf Of Dishaa
Sent: Wednesday, May 09, 2007 8:34 AM
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Documentation Tool in Linux Environment

Hi,

I am technical writer for a software company that requires quite a bit
of documentation work for its software applications. Few things
regarding the present scenario:


Currently, there are no standards or documentation in place.
The direction the company wants to take is have a tool that will
enable printed output and On-line Help files where the requirement
maybe.
The office runs on a Linux environment and I was wondering which
would be the best tool to use in this scenario.
The document categories maybe - User Manual, Developer Guide,
Policies and Guidelines Manual, and so on.

Therefore, which is the best tool considering the types of documents,
the work involved - setting templates and having multiple outputs, and
the environment.

I had in mind DocBook, but considering I am not well-versed in XML,
would like to know the alternatives. Or is DocBook use able enough even
for a beginner.

I would hugely appreciate if the soundly advised members of the
community could provide valuable suggestions and recommendations.
Gratefully,Dishaa



Dishaa Ganapathy
215 North Ave, NE
Atlanta, GA 30308
Tel: 678-925-2072|Email: dishaag -at- yahoo -dot- com

"The real voyage of discovery consists not in seeking new landscapes,
but in having new eyes." - Marcel Proust


---------------------------------
Expecting? Get great news right away with email Auto-Check.
Try the Yahoo! Mail Beta.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create HTML or Microsoft Word content and convert to Help file formats
or
printed documentation. Features include support for Windows Vista & 2007

Microsoft Office, team authoring, plus more.
http://www.DocToHelp.com/TechwrlList

Now shipping: Help &amp; Manual 4 with RoboHelp(r) import! New editor,
full Unicode support. Create help files, web-based help and PDF in up
to 106 languages with Help &amp; Manual: http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as cvickery -at- arenasolutions -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/cvickery%40arenasolut
ions.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.


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

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.
http://www.DocToHelp.com/TechwrlList

Now shipping: Help &amp; Manual 4 with RoboHelp(r) import! New editor,
full Unicode support. Create help files, web-based help and PDF in up
to 106 languages with Help &amp; Manual: 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:
Documentation Tool in Linux Environment: From: Dishaa

Previous by Author: RE: "Appears" vs. "will appear"
Next by Author: RE: Documentation Tool in Linux Environment
Previous by Thread: Documentation Tool in Linux Environment
Next by Thread: RE: Documentation Tool in Linux Environment


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


Sponsored Ads