Message: previous - next
Month: November 2011

Re: [trinity-devel] Trinity User's Guide

From: Kristopher John Gamrat <chaotickjg@...>
Date: Thu, 17 Nov 2011 12:27:01 -0500
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.

Kristopher Gamrat
Ark Linux webmaster