Suggestions for free/cheap/Open Source documentation for Web Site & PDF?

Subject: Suggestions for free/cheap/Open Source documentation for Web Site & PDF?
From: Jen H <documentation -at- voxilate -dot- com>
To: TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 14 Jul 2009 21:29:57 -0400

Hi, all:

I've been out of the documentation loop for a few years and thought I'd
query the group for more modern insight. I'm helping out a project where
we'll be producing documentation that we'll need to output in both PDF and
as nice-looking Web pages. I've batted around a few ideas - LaTeX (nice and
build-system-happy, but LaTex2HTML is so ugly...plus we'll eventually want
many people to update it and not everyone loves LaTeX), Apache Forrest (but
it doesn't seem to be heavily maintained and doesn't work with JDK 1.6. This
is, I guess, not a big deal, but resetting JAVA_HOME all the time is a
pain).

Requirements are really the following:

- Text-based source for easy integration with source control.
- Free, or close to it.
- Single-sourceability: Should be able to code text for multiple output
streams/audiences.
- Multiple output formats supported, PDF and HTML at a minimum.
- Can be built without user interaction (i.e., scriptable to run with
automated builds).
- Somewhat easily editable - Eclipse plugin support would be fantastic.
- Pain threshold for initial configuration is medium (<2 hrs to set up, fine
if it takes a little longer to make "pretty"). Pain threshold for
maintenance/modification of styles/build system/internals post-initial setup
is high, however.

Any advice or suggestions? What's working for you in the land of free
software? Is anyone successfully using Maven to produce user documentation?
(Anyone using Forrest?) Any other out-of-the-box DocBook implementations
that are easy to get up and running quickly? Or other suggestions and
advice?

Thanks much in advance for your insights and recommendations!

- Jen
<documentation -at- voxilate -dot- com>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Free Software Documentation Project Web Cast: Covers developing Table of
Contents, Context IDs, and Index, as well as Doc-To-Help
2009 tips, tricks, and best practices.
http://www.doctohelp.com/SuperPages/Webcasts/

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


Follow-Ups:

Previous by Author: Re: Microsoft Manual of Style where oh where
Next by Author: RE: TOC field frustration
Previous by Thread: RE: Hyphenation on Web Application Pages
Next by Thread: Re: Suggestions for free/cheap/Open Source documentation for Web Site & PDF?


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


Sponsored Ads