Re: Announce: Grace project site operational

[dennison@telepath.com (Ted Dennison)]

Stephen Leake <stephen.a.leake.1@gsfc.nasa.gov> wrote in message news:<uznz4nfd7.fsf@gsfc.nasa.gov>...
> Before we have more discussion, I'd like to make sure there is a
> mechanism for capturing the resultant decision and rationale in a
> useful way, so we don't have to do it again next year :).

Dang, that makes good sense. It needs to be up on the website
somewhere to, so we can point people who want to reopen old wounds to
it.

> For example, a design and rational document for Grace would be good
                            ^^^^^^^^
                            rationale.
I'm the worst person in here to be dissin' on someone else's spelling,
but this one always rubs me the wrong way. Sorry.

> Now I'll start another controversy; do it in LaTeX :).
> 
> Actually, I think texinfo is good for Gnu projects. Some seem to be
> using DocBook, which I've never used.

From what I understand about it, I'd be inclined to pick texinfo
(which I understand is a flavor of TeX) out of the choices you have
above. It is the official Gnu doc system, so that's what all the Gnu
tools are set up to use. Also, it provides for producing both HTML and
typeset versions. Apparently it can be processed by TeX proceesors
too.

Note that no-one would deal with the texinfo documentation "sources"
directly, unless they are updating them. Readers would use either the
generated HTML versions, or some ready-for-printing format like
Postscript or Acrobat.

> Of course, flat ASCII isn't bad!
I'd go for HTML before that, just to get a little formatting.

-- 
T.E.D. 
Home     -  mailto:dennison@telepath.com (Yahoo: Ted_Dennison)
Homepage -  http://www.telepath.com/dennison/Ted/TED.html (down)