Re: [Aimmath-developers] AuthoringGuide

[Greg G. <gr...@ma...>]

On Tue, 9 Sep 2003, Gustav W Delius wrote:
> Ken,
> 
> I really like your Authoring Guide. It would be very nice if we could have
> the contents of syntax.html included in that document as a first chapter.
> Are you already working on that? Or do you want someone else to do that (no,
> I am not volunteering :-)). I assume you are using tex to produce the pdf?
> Would you share your style file?

Dear all,

While it's nice to have documentation in other formats, I think it's 
important to have a `standard' format, which up until now has been
HTML, most of which is autogenerated by AIM via Maple. So, I'd like to
see the Authoring Guide in HTML format. Also, I'd like to see the 
documentation for Rand with all the other documentation. It doesn't
hurt to have other formats available as well, but rather than produce
a whole lot of different pieces of documentation in a hodge-podge way,
it should be consistent ... to do this means accepting one format as
a base format, inventing some rules about style (largely done already
by Neil when he created the auto-documentating tools for AIM), and 
creating tools to convert from the base format to the other formats.
The base format could be HTML or it could be LaTeX or even XML.

IMHO, if we are to go down this road, I'd like it to be LaTeX,
which would mean defining the style and tailoring a LaTeX-to-HTML
tool to give output that matches the existing AIM auto-documentation.
Perhaps, Neil already has such a tool that he used to generate 
syntax.html etc.??

  Regards,
  Greg