Re: New DevMo Roadmap and Progress

Deb Richardson <[email protected]> Fri, 18 Mar 2005 08:04:13 -0500
Newsgroups gmane.comp.mozilla.documentation
Message-ID <[email protected]>
Axel Hecht wrote:

> http://developer.mozilla.org/docs/index.php/JavaScript:References:Core_JavaScript_1.5_Reference 
> 
> This looks kinda horrible, doesn't it?

Well, during the discussion with the devmo drivers there were complaints 
that a wiki could not sustain any form of heirarchy or automated 
breadcrumb generation.  I dug around to see if anyone else was using 
MediaWiki to do book-like documents within a heirarchical structure and 
found wikibooks.org.  Mike Shaver also graciously volunteered to write a 
MediaWiki extension for me that does the automated breadcrumb 
generation, and it works off the pagenames.

It is not a perfect or "ideal" system, no, but we can trade off pretty 
urls to get the heirarchy and breadcrumb generation.  MediaWiki links 
also support having different text than target, so

[[JavaScript:References:Core_JavaScript_1.5_Reference|Core JavaScript 
1.5 Reference]]

would just display

Core JavaScript 1.5 Reference

just as

[[JavaScript:References:Core_JavaScript_1.5_Referenz|Core JavaScript 1.5 
Referenz]]

would display

Core JavaScript 1.5 Referenz

Yes, the URLs and links can get unweildy.  The config can be tweaked to 
eliminate the "index.php" part of the URL, which we will obviously be 
doing.  I think the imperfect URLs are a fair trade for all of the 
benefits a Wiki system provides coupled with the heirarchical structure 
and automated nav generation.

I could be wrong.

~ deb