Oct 072007

Everyone’s had that time they looked for something on MDC and either totally failed to find it or found an article that was beyond unhelpful.  Let’s face it, there’s a lot of material there, and some of it isn’t as helpful as it should be.

So complain to me!  Tell me: what was the last article you looked at and wound up scratching your head and asking yourself any of these questions:

  • Who wrote this crap?
  • Why, oh why, did they subject me to this?
  • What the hell was that trying to say?
  • Was this written by an illiterate baboon?

Help me figure out which of our existing documents need attention so they can get it!  We have limited writing bandwidth still (volunteers are urgently requested!), so getting a list of the articles most in need of help would be a huge help in terms of targeting our work.

 Posted by at 7:04 PM

  2 Responses to “Complain to me, baby”

  1. (Zounds, different layout!)

    I direct you to bug 398777, which I filed a few days ago over some not-quite-precise, not-quite-informative, not-too-useful documentation that needs expansion and clarification. :-)

  2. http://developer.mozilla.org/en/docs/XPCNativeWrapper confuses many people, even though it’s very precise. I keep seeing people who think they need to wrap JS objects (when accessing content from extensions) in order to do what they want (typically unsafely access content JS objects). We could use a lighter article that uses less precise and simpler language, perhaps organized as a FAQ and with examples. The original page probably shouldn’t be mucked with though, since it’s easy to change meaning inadvertently and it’s important to have precise explanation of what’s going on.