Aug 122010

Obviously, Janet and I are heads-down working on Firefox 4 documentation these days. I thought today would be a good day to share a bit about what’s going on there.

Help us help you help others

First off, my traditional plea: if you’ve got code you’re working on that even might impact documentation, please add the “dev-doc-needed” keyword to the relevant bug or bugs. This will bring it to the attention of the writers. If there isn’t a relevant bug (or the relevant bug is extremely arcane), you can alternatively just add a blurb to the Firefox 4 for developers page or the New in JavaScript 1.8.5 page, as appropriate.

New and updated documentation

Now that that’s out of the way, let’s see what I’ve been up to, writing-wise. Having finally battled my way out of a crippling, multi-month writer’s block attack, material has finally started pouring out in quantity again in the last week or so.

  • The js-ctypes documentation is now finally complete. I’m not yet totally satisfied with the organization of the material, but it’s got all the facts in place now. I’ve requested a technical review of that documentation.
  • The buffered attribute on audio and video elements is now documented, as are the underlying XPCOM and DOM interfaces.
  • The DOM window.mozPaintCount property has been documented.
  • I’ve written up the X-FRAME-OPTIONS HTTP response header.
  • Added the new page Securing your site, which provides convenient links to articles about web site security.
  • Updated the documentation for the JavaScript Date object to indicate the new support for ISO 8601 dates.

That’s some real progress. Lots left to do, of course, but that’s always the case, right?

 Posted by at 2:31 PM

  One Response to “Firefox 4 documentation”

  1. Can the code snippets get tested and labeled as “tested with Firefox 4.0” after the APIs are frozen for Firefox 4.0? Thank you