some proposed documentation revisions



--- Robert Dodier <robert_dodier@yahoo.com> wrote:

> Hello everyone,
> 
> I have some ideas about documentation revisions that
> I would like for you to review. I am aware that there 
> is a long-term plan to rework the documentation from
> the ground up, however, I think the existing need for
> improved documentation merits some changes right away.

Please!  If the will exists to do it, by all means!
 
> I am interested in revising the texts returned by
> the DESCRIBE function. There are many texts which can
> be brought up to date, expanded, and clarified. As
> examples of the kinds of changes I propose, you may
> consider looking at "Proposed documentation revisions"
> at the Maxima wiki, 
> 
>   http://maxima.sourceforge.net/wiki
> 
> I believe that I'll be able to make useful improvements.
> You can let me know if you agree.

Looks good on a quick read through - my only comment is
that it might be useful to give a quick list of the 
commands available in FFT.  I know the demo does most
of that work but it's nice to have a generalized form 
describing how the commands work, as well as functional
examples to help you decode the general description.  That 
could be just me though.

CY