On Thursday 17 November 2011 12:17:00 pm Timothy Pearson wrote:
Overruled. :-) The consensus here (which I agree with) is that no markup languages are needed or desired. This documentation could potentially grow to the size of a small book--can you seriously even imagine trying to edit that for clarity, let along grammatical errors, without a word processor? There is a right tool for the job, along with a bunch of wrong, but workable, tools. Let's use the right one!
We will use the flat ODT format in GIT. I will work on getting automatic builds both to "real" document formats (PDF, PostScript) and to HTML. Help is welcome here; basically I just need the command line to pass to LibreOffice to make it spit out such documents, especially on the HTML end.
As long as there's public read access on the web site, that shouldn't be a problem. There was a comment earlier that people won't want to learn (or won't understand) version control, so making it downloadable in a browser without a "git clone" is desirable. If that's possible, I'm all for using git for the manuals.