[Mono-docs-list] [mono-packagers] monodoc & mcs/mono module merging

[Néstor Salceda]

El mar, 21-10-2008 a las 00:59 -0400, Jonathan Pryor escribió:
> Background: we'd the treeview to be generated at runtime, so that
> distros don't need to patch monodoc.xml to add additional documentation
> (without placing all additional documentation under the Various node).
> 
> This is doubly useful when we have projects like Gendarme looking to
> integrate their documentation (see the gendarme google group), but the
> patches I've seen for that _also_ involve monodoc.xml changes, so the
> current monodoc.xml architecture hostile toward 3rd parties...

	Yes, that's true.  I could do it adding a <source> tag in the .source
files, but then I have several Gendarme.Rules ... nodes without a
relationship among them, under Various, and I will prefer group those
nodes under a Rules node (because perhaps a Framework node should be
added too).  I had thought about send a patch to monodoc.xml, but I
prefered wait until this stuff is finished :)

	Personally, I like the solution you have thought, nesting in
the .source files.

> With luck, we can get this finished for Mono 2.2...

	Nice, if I can help you with something; I'll be glad to do it.

[...]
> It's ~fully dynamic, so if any additional structure is desired by a 3rd
> party, they can ~trivially add it.
> 
> Thoughts?

	Well, as it allows defining "complicated" nesting I like it.

Néstor.