Re: Web Developer Wiki

fantasai <[email protected]> Fri, 11 Feb 2005 14:52:29 -0500
Newsgroups	gmane.comp.mozilla.documentation
Organization	Another Netscape Collabra Server User
Message-ID	<[email protected]>
[email protected] wrote:
 >
> There is the Mozilla Documentation project
> (http://www.mozilla.org/contribute/writing/), but I feel more would
> improve it if was a lot easier to contribute (with Mozilla when you
> click 'edit this page' at the bottom of the page, the whole page is
> edited rather than just the content).

If you scroll down a bit past the <head>, you'll see that it is really
just the content. The navigational stuff is added later. However, we
use full HTML files for the source -- this lets you add links to style
sheets, edit the title and DOCTYPE appropriately, and view/validate the
document before you submit it.

> Just go to
> http://www.mozilla.org/docs/dom/domref/ (which is what web developers
> are really interested in, not sure who maintains it)

Yeah, there are several roadblocks in the maintainance of the DOM Ref.
The primary one is that we need to move it (and a lot of our other
api docs) to an XML format internally, but we haven't settled on a
suitable format yet. Michael Nachbaur, who runs MozRef, was looking
into this, but I think he's quite busy these days. If you (or anyone
else for that matter) can handle XML/XSLT work, feel free to shoot him
an email and offer to help.

> With Mozilla you search the site using Google, and that searches
> everything (when all you may want to do is search Web Development
> related information).

Search should work better once we move all the relevant developer
documentation to DevMo.

> You can get a list of styles with a bit of JavaScript (styles start at
> azimuth), but from that you can't see how to use them, and what they
> are for.

Anne has done some work on documenting CSS properties. It should be ready
to go up on developer.mozilla.org pretty soon. :)
See bug 281960:
   https://bugzilla.mozilla.org/show_bug.cgi?id=281960

~fantasai