This is not even a rough draft -- I started to respond to an email (copied below), then realized I wanted to gather more information before sending a response. This page is a collection point for that information (and a few sentences I started writing as the response).

Things to gather:

• Pick a good Wikilearn or TWiki web page as examples of what can be done with documentation. Include some with sketches.
• Collect a web address for the ldp wiki, and some words about the intent and current status.

Start of response:

I don't want to do anything to derail your efforts to get a manual put together, and that is not the intent of this note.

The intent is to suggest that you consider using a wiki.

I may have known at one time, but I forget -- is Hercules open source or free software, or is it proprietary? What license(s) is it available under?

The reason I ask is that the ldp (Linux Documentation Project) has started to develop a wiki specifically to aid in the authoring process.

Subject:  [H390-DOCS] One other documentation issue; CVS?
    Date:  Sun, 17 Feb 2002 21:03:29 -0000
   From:  "bh_mayor" 
Reply-To: H390-DOCS@yahoogroups.com
     To:  H390-DOCS@yahoogroups.com

bh_mayor wrote: > Herculeans:
>
> If we are to write any sort of manual the most logical thing to do
> is to manage it with some sort of "CVS" style technique so that it
> would be possible for folks to work on certain sections (once a
> formal layout of the table of contents has been drafted and
> accepted) as they go.
>
> I am not quite sure how we would generate a new version of all the
> sections on a regular basis, for pier review, but advice and
> commentary on this area is also needed.
>
> Stuart
> Beverly Hills, CA
>
> ------------------------ Yahoo! Groups Sponsor ---------------------~-->
> Get your FREE credit report with a FREE CreditCheck
> Monitoring Service trial
> http://us.click.yahoo.com/ACHqaB/bQ8CAA/ySSFAA/sVPplB/TM
> ---------------------------------------------------------------------~->
>
> To unsubscribe from this group, send an email to:
> H390-DOCS-unsubscribe@yahoogroups.com
>
>
>
> Your use of Yahoo! Groups is subject to http://docs.yahoo.com/info/terms/

Contributors

• RandyKramer - 18 Feb 2002
• <If you edit this page, add your name here, move this to the next line>