[Mono-docs-list] DocStatus tool

Miguel de Icaza miguel@ximian.com
13 Jun 2003 10:23:56 -0400


Hello!

> I have created a small tool to generate the status of our documentation
> (mostly for Gtk#, but it works for ECMA also).  It currently consists of
> DocStatus.cs which generates an xml file, and DocStatus.aspx that reads
> the xml file.
> 
> To try it you will need a mono compiled since Duncan's IHasXmlNode patch
> the other day. Here is a usage example:
> mono DocStatus.exe gtk-sharp/doc/en Gtk#
> 
> where gtk-sharp/doc/en is the starting directory and Gtk# is the "Name"
> used for the xml filename. Then put DocStatus.aspx and Gtk#DocStatus.xml
> into your xsp directory.
> 
> Here are some of the current limitations:
> - the documented / not documented decision is not great
> - perhaps one large xml file for all the docs would be better instead of
> how it's done now
> - the aspx page is not very pretty
> 
> Any suggestions or comments would be appreciated.  Especially by Miguel
> and Ben on fitting it in to the new website.

I think we could host this on the new machine mono.ximian.com, I will
give Duncan access to the machine so he can setup Mono + XSP in there
(I have an old instlalation there).

But this is very useful, and should help the documentation effort.

For now, if you can generate static files, we can host those in a
directory in the current web server.  Am  gone next week to Guadec, so
it might be hard for me to get this done.

 Miguel