Interesting thoughts. So what you want to do is:
1. Use a documenation package like doxigen to gather the documentation
data (let's say in XML format)
2. Write some PHP or Perl code to:
2.1 Parse the XML data
2.2 Generate Class and Method Information in Wiki-format
2.3 Use the Media-Wiki API to automatically update/create new wiki-pages where these information are stored
3. Then these class/method information pages are included into the reference pages using wiki-tags.
Wiki-Users would then be able to add code examples and link tutorials to the reference, but the actual Framework reference is created and updated automatically.
This would be quite some project. I took a look at Doxigen, ran it with the Joomla 1.5 source-code and took a look at the XML output: It seems like Doxigen is getting along with phpDoc style comments quite
well. I say quite, because I immeadiately recognized one minor and one major flaw, which might make a complete rework of the code-documentation
The minor flaw is, that (like phpDoc) Doxigen differentiates between brief description and detailed description. However, Doxigen does interpret phpDoc brief descriptions as detailed descriptions.
A major flaw is that Doxigen expects the property name of a method where phpDoc expects the data type. This means that the "string $query" property would be named "string" by Doxigen.
Leaving these two observations behind for the moment, I'm pretty sure that this could be an interesting project, and if planed well, could also be easily extended. I'm talking about extensions, because in the end, I would really like to be able to access the source code from the API reference with just one click, like it is currently possible at api.joomla.org. With all the information at hand, that doxigen provides us, it would be easy to write a class that pulls the source code out of the file, and creates a new/edits an existing wiki page and puts the source coude into
Well there certainly needs to go a lot of thinking into this. But this is a surely refreshing idea, and worth looking into.