MDN/Archives/Community meetings/2011/2011-04-13

From MozillaWiki
Jump to navigation Jump to search

Agenda/Notes

Content development

  • Firefox 5 documentation is underway; please be sure to add relevant links to Firefox 5 for developers. See Florian's bug tracker for the bug list and notes.
  • Firefox 5 bugs should have target milestone set to Fx5/Mozilla5.
  • Compatibility tables
    • All open web content (HTML, CSS, DOM, JavaScript, SVG, MathML, etc) should be migrated to using the new compatibility tables.
    • In addition, articles should be revised to move any Gecko-specific stuff into the tables, or into footnotes if they can't be worked into the tables.
    • Goal: to make the open web content platform-agnostic.

Tools

  • At the MoCo all-hands, we discussed ways to improve our reference documentation process, and the idea was proposed that we develop a tool that would pull an IDL or header file, let you edit it, test the JavaDoc HTML output, then let you submit a patch with a diff of the comments once you were finished in order to get edited comments into the tree. This would let writers work more or less directly in the headers and IDL files with a minimum of effort, and we could then switch to automatically generated reference documentation.
  • Trevor will be updating his MDN interface documentation generator extension to handle the new release train process soon.