Christian Biesinger wrote:
Boris Zbarsky wrote:
Well... that suggestion gives you interface documentation, indeed. It does NOT give you documentation of contracts, like: 1. who implements this interface, 2. what other interfaces does this implement (that you can rely on), 3. how you should get a component implementing this interface (for example, nsIURI and nsIMIMEInfo should not be created by contractid).
True. We need contractid documentation in general. #3 could be documented in the IDL itself, though, imo. But yes, we need a way tolink from the interface documentation to the contractid docs... preferably semi-automatically. Perhaps some sort of file that contains such relationships (either in the sourcetree or on the site).
The xulplanet XPCOM docs are the best I've seen. We should ask Neil how it's done, and if he'd be willing to help with that part of the project. Don't want to reinvent the wheel.
--BDS _______________________________________________ mozilla-documentation mailing list [EMAIL PROTECTED] http://mail.mozilla.org/listinfo/mozilla-documentation
