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

_______________________________________________
mozilla-documentation mailing list
[email protected]
http://mail.mozilla.org/listinfo/mozilla-documentation

Reply via email to