Ranking documentation: Importance

Another of my tasks for the coming weeks and months is to prioritize work on various pieces of our documentation, in terms of making improvements and ensuring that we have great translations into all the languages of our many community members.

So I thought I’d get some input from the community on this.

If for some reason you could only have three pieces of the documentation on the Mozilla Developer Center, what would they be?  For the purposes of this particular exercise (there will be more), let’s consider only existing documentation.

You don’t have to like the documents, you might even think they’re bad (in which case please tell us that you think so), but the idea here is to build a list of documents that we most need to ensure are of the highest quality and visibility.

So… which are your three?

4 Responses to “Ranking documentation: Importance”

  1. Johnathan Nightingale says:

    Hey sheppy,

    I’d argue that one of the most important pieces is the “Building an Extension” article ( http://developer.mozilla.org/en/docs/Building_an_Extension ). Not only is add-on development a crucial part of building firefox to suit changing needs, but I think it’s a great way for new people to get involved with the codebase, without having to swallow it whole.

    I know that’s not 3, so I’ll let someone else suggest 5 to even things out. :)

  2. Myk Melez says:

    The three documents I use most often are:

    http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference

    http://developer.mozilla.org/en/docs/XUL_Reference

    http://developer.mozilla.org/en/docs/Build_Documentation

    (roughly in that order)

  3. Simon says:

    Mine are:
    http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference
    http://developer.mozilla.org/en/docs/Gecko_DOM_Reference
    http://developer.mozilla.org/en/docs/XMLHttpRequest

  4. shaver » talk to me, baby says:

    [...] tell Sheppy which of the hundreds of documents on MDC you think are the most important, over in his blog post. posted 24 September 2007 @ 10:09 • tagged documentation, mozilla, [...]

Leave a Reply

Line and paragraph breaks automatic.
XHTML allowed: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>