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
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.
Ark Linux webmaster