[Mono-docs-list] Long term Monodoc feature requests.

Todd Berman tberman@sevenl.net
Wed, 09 Jun 2004 20:27:05 -0400


I have a couple longer term feature requests for Monodoc, some of which 
I might be interested in implementing, but all that I would like 
feedback on.

1) Make the zip files smaller. Right now it can take almost an hour to 
build the classdoc zip file for the main docs on my machine which is 
pretty painful. It seems to take forever because of the raw size of the 
material. If this zip file was split into zip files by namespace, or zip 
files by assembly, I think it would be a far faster update process. This 
change should be hidden from monodoc.dll consumers (the browser, 
MonoDevelop, and the web frontend).

2) Register docs not through the main monodoc module. Monodoc has 
wonderful editing facilities, useful for .net projects outside of just 
mono + gtk-sharp. If it were easy/possible to register zip files in a 
way other than through the one .xml file, that would make it far easier. 
As it stands even now, the debugger puts docs into place that monodoc 
wont load for some reason. We could even potentially remove the need for 
the xml file and have some special file put into the .zip file that 
monodoc looks for to identify why sort of provider to use. This is 
another change that should be hidden from the various monodoc.dll consumers.

3) Sharing gui. MonoDevelop (and potentially later others) are 
integrating with monodoc already, and the need to rewrite all the gui 
that monodoc has seems kinda backwards. It would be nice if there was a 
way of using the gui in the monodoc browser in other places, that would 
make things like history, the index, etc, a lot easier to deal with for 
tools trying to use monodoc.

4) Split the modules up. Right now the monodoc module in cvs is a beast. 
It would make a lot more sense to have 2 (potentially 3) different 
modules. The first would be monodoc-tools which would contain 
monodoc.dll, the assembler, etc, and most likely the current doc stuff. 
The second would be just the monodoc gui frontend(s). The potential 
third would be the web based frontend. This would be wonderful for stuff 
like gtk-sharp, as it would allow gtk-sharp to dep optionally on the 
monodoc-tools module/release and build its own docs the right way.

5) Integrate with either Lucene.Net or beagle to provide searching. This 
one basically speaks for itself :).

I know some of these are very big and very much long term, but it would 
be great to get some feedback going.

--Todd