[Mono-docs-list] Proposing a new documentation subsystem
Miguel de Icaza
miguel at novell.com
Mon Dec 3 15:26:21 EST 2007
> I spoke with Lluis Sanchez about using Mono.Addins to extend the
> documentation system and it seems a good approach because we will get
> all the subsytem for documentation updates and managment (both for
> providers and for doc sources) for free.
> This will enable downloading new docs or providers without updating
> the whole monodoc system. We can also get rid of the several xml files
> needed to finally reach the documentation files and free monodoc
> subsytem of some managment code.
> Once I have something workable I will post here for further discussion.
Which kind of add-ins do you have in mind?
I love add-ins where they make sense, but I do not love add-ins for the
sake of having an add-in. If we have a genuine reason to support a new
file format we should decide whether there is a good reason to not have
it as part of the core mono documentation system.
Supporting downloading updates is a pipeline issue more than an "add-in"
issue. Sure, you can write an add-in, but the fundamental issues are:
* Someone needs to write the new docs (these happen at glacial
* If the above were fixed (hundreds of new docs per day),
updating docs should just be part to the core Monodoc
More information about the Mono-docs-list