Notes on doc-needed bugs

  • Revision slug: Project:Notes_on_doc-needed_bugs
  • Revision title: Notes on doc-needed bugs
  • Revision id: 98042
  • Created:
  • Creator: Sheppy
  • Is current revision? No
  • Comment 64 words added, 58 words removed

Revision Content

The following list is based on dev-doc-needed+RESOLVED Bugzilla query. However, this list is manually maintained, and therefore may not be completely current. You can help by adding bugs that appear in the query but not in this list, with as much information as you can.

If you decide to work on one of these bugs, please add your name to the Doc Owner cell for that bug.

If you have questions about the documentation effort for any particular bug, you can add a comment to the bug, or ask in #devmo on irc.mozilla.org or the dev-mdc@lists.mozilla.org mailing list.

Doc needed

Doc priority is on a scale from 1-5, where 1 is "OMG URGENT!!1!" and 5 is "meh."

Bug ID Title Doc Priority Doc Scope Doc Owner Notes
{{ Bug("435041") }} implement Cocoa NPAPI event model for Mac OS X 1 Large   Massive update to the plugin developer docs for Mac OS X. To support 64-bit plugins, plugin developers need to switch to this new event model.
{{ Bug("472529") }} (websocket) Support for Web sockets' HTML5 Draft Recommendation 1 Large   On hold pending spec changes. See {{ Bug("616733") }}
{{ Bug("501423") }} StorageEvent implementation does not match the spec 1     Needs to be done for Fx4. Update StorageEvent docs to match implementation (and spec).
{{ Bug("546590") }} (harmony:proxies) Implement Harmony Proxies [ES6?] 1 Hard  

Brendan Eich recently did a presentation on this (http://www.slideshare.net/BrendanEich/metaprog-5303821). See also http://wiki.ecmascript.org/doku.php?id=harmony:proxies

jorendorff to provide examples: "Proxies are just like __noSuchMethod__, times a million. * __noSuchMethod__ only goes to work after a method isn't found. Proxy hooks, instead, fire right away, completely replacing the normal method/property lookup."
{{ Bug("553413") }} (async-IndexedDB) Implement Asynchronous parts of the Indexed Database API 1   Janet On hold waiting for spec to settle. This is a placeholder for IndexedDB doc work.
{{ Bug("579178") }} Don't enumerate components/*.manifest and chrome/*.manifest 1     See comments 30 and 31.
{{ Bug("587931") }} Add support for document.currentScript and script-started script-ended events 1     Docs have been written, but aren't quite useful. See comment 20.
{{ Bug("59314") }} Alerts should be content-modal, not window-modal 2   Sheppy Actively working, should be done soon (as of 2010-12-09)
{{ Bug("368835") }} No focus events from xul tree table when a row is deleted 2     Need better docs of tree-related events.
{{ Bug("398776") }} (doorhanger) want mechanism for site-specific notification 2     New API for creating doorhanger notifications. Needs sample code (based on tests?) and screenshots.
{{ Bug("407963") }} [FUEL] Factor out generic toolkit aspects of FUEL into a reusable form 2     FUEL is an abstraction layer between extensions and interfaces. Doc work may be done, or may be incomplete. Need to compare the state of the docs and the state of the code.
{{ Bug("460882") }} setTimeout loses XPCNativeWrappers 2 Small   Need to find all the places to mention it. Need to check whether the API change is already documented.
{{ Bug("511761") }} Only use compatibility.ini (not .autoreg, or stat()s) to invalidate fastloads and other caches 2 Unknown   See comments 43 and 54. Needs to be scoped. Pretty deep voodoo sounding stuff.
{{ Bug("513162") }} [Windows] Drawing in the Title Bar for the New Firefox Theme 2 Trivial   See comment 164; despite the huge bug ticket, the doc change is very minor.
{{ Bug("517580") }} Make JS_HAS_GETTER_SETTER always 1, remove support for old-style getters and setters 2 Easy  

Waldo blogged about this: http://whereswalden.com/2010/04/16/more-spidermonkey-changes-ancient-esoteric-very-rarely-used-syntax-for-creating-getters-and-setters-is-being-removed/

Waldo says: could summarize as "various non-standard syntaxes for defining getters and setters have been removed; syntax defined by ES5 has not been touched". There aren't any newly-obsolete functions.
{{ Bug("520696") }} Implement support for |{ get "string literal"() { /* ... */ }, get 5.4() { /* ... */ }, 6.72: 3 }| 2 Probably easy   Looks scarier than it probably is. Need to update https://developer.mozilla.org/en/JavaScript/Guide/Values,_Variables,_and_Literals#Literals. Plus wherever we have reference docs that apply.
{{ Bug("536472") }} ES5: { get x(v) { } } and { set x(v, v2) { } } should be syntax errors 2 Easy   This sounds like it may be a simple matter of a note in the ES5 page that says that this syntax is checked correctly now. And make sure that any changes that might be needed are made to https://developer.mozilla.org/en/JavaScript/Reference/Operators/Special/get and the corresponding set page.
{{ Bug("537873") }} Assignment to readonly properties should throw a TypeError in strict mode 2 Trivial   Need to note that strict mode now throws a TypeError in strict mode instead of silently failing if you try to change readonly properties. As usual, need to double check to be sure that if the old behavior is specifically mentioned anywhere, we update it.
{{ Bug("542406") }} readonly="true" doesn't work on fields 2 Easy   Just need to fix docs that were put in the wrong place.
{{ Bug("543444") }} Replace single-view API with multiple observers 2 Moderate   The interface references are updated for this, but the sample code and how-to guide mentioned in comment 38 need updating. Might be able to extract info from tests. Follow up with Marco re example code.
{{ Bug("543910") }} [Windows] Improve Windows OS theme detection for Firefox.next 2 Easy   New media query that lets you detect which theme is being used on Windows (for theme authors).
{{ Bug("595937") }} Need support for customizing toolbars which are outside of the toolbox 2 Easy   An API to let you indicate which toolbox a toolbar should be associated with if it's not actually contained within the toolbox.
{{ Bug("599693") }} Allow developers to run mochitest-1 ... mochitest-5 by simply specifying those as a make target 2 Easy   An addition to the QA and build docs to say you can do make mochitest-X to run tests.
{{ Bug("264308") }} Implement DOM Level 3 UserData API 3     Old bug, needs someone to figure out how it works. The spec is not very helpful. Needs to be scoped. Might need its own doc bug.
{{ Bug("321169") }} XUL templates need better logging capability 3     Basically should amount to "how do you turn on and off logging of XUL templates". Add a link to https://developer.mozilla.org/en/XUL/Template_Guide for a "Debugging XUL templates" page.
{{ Bug("391829") }} Add support for container-live-role to object attributes 3 Easy   Add container-live-role to https://developer.mozilla.org/index.php?title=en/AJAX/WAI_ARIA_Live_Regions%2F%2FAPI_Support (is Ajax the correct topic here?)
{{ Bug("399537") }} XPIDL documentation needs to be migrated and overhauled 3     XPIDL is the language used when creating IDL files to define interfaces. Newcomers to the project need to know this.
{{ Bug("433616") }} [FIX]Need facility for managing documents referenced via local URI references 3 Large   Needs research (probably more research than writing). Need to identify everything that gains cross-server support because of this change and update the relevant docs.
{{ Bug("451729") }} Allow runtime's security callbacks to be overridden by a context 3     JS runtime docs changes. May have been started by jorendorff; unclear if it's finished.
{{ Bug("501925") }} Change cookie policy to relax the mailnews-specific APP_TYPE_MAIL requirement 3 Unknown   Thunderbird-specific. Needs scoping.
{{ Bug("507012") }} Need an efficient and convenient execution tracing API for profiling 3 Easy   This will make it much easier for extension developers to find and fix their performance problems. API change for the JS runtime that lets you profile JS routines using a callback that gets run on function enter and exit. Should also get mentioned on the "Improving your extension's performance" page we need to write.
{{ Bug("529404") }} Assignments to a property that has a getter but not a setter should only throw a TypeError in strict mode 3 Easy   Blogged at http://whereswalden.com/2009/12/21/ecma-262-ed-5-backwards-incompatible-change-coming-to-spidermonkey-and-to-gecko-based-browsers/ (per comment 11). Need to track down all the places where it needs to be mentioned, both in the JS reference and in the JS guide, as well as in "New in JavaScript 1.8.5" and the ECMAScript 5 docs.
{{ Bug("541373") }} Provide a global VACUUM component 3   Marco Bonardo [:mak] ? The reference docs are written for this, but we could use an example for how to use it added.(Need to follow up with Marco re additional doc he was going to do.)
{{ Bug("562446") }} ES5: array functions don't work on non-arrays 3     Update the JS reference pages on array functions (toString, toSource, toLocaleString), plus add notes to the ES5 page and possibly changes to the JS guide.
{{ Bug("568863") }} Performance measurement utility 3 Easy   This is partially documented already: https://developer.mozilla.org/en/JavaScript_code_modules/PerfMeasurement.jsm Needs to be adapted into reference docs for the code module. (Should be easy based on existing info) Link to this from the TBD extension performance article.
{{ Bug("573588") }} Implement Desktop Notifications 3     This is a new API for letting content create notifications to the user (a la Growl on the Mac). Update navigator.mozNotification doc. Example code and screenshots for various platforms would be nice.
{{ Bug("427293") }} "Secure Connection Failed" makes it difficult to work in the web hosting industry 4 Small   At most, this is documenting a preference that most users won't touch. Start a list of "super secret use-at-your-own-risk" preferences?
{{ Bug("494345") }} Do not create accessibles for XUL label or description having a role of 'presentation' 4 Easy   Small API change. Should only take minutes.
{{ Bug("501490") }} Enable Taskbar Previews for Windows 7 4     Reference stuff is mostly written, might need updating. To do: Make sure interface docs are up to date, then try to get a sample working.
{{ Bug("514120") }} Style resolution shows up as a serious cost when wrapping DOM nodes that have no frames 4 Moderate   This is a simple note that needs to be made, but figuring out where to put it will take some research.
{{ Bug("521141") }} Start menu / programs shortcuts pinned to the taskbar don't group correctly 4 Probably easy   Good for someone familiar with the Windows installation process. This is about how to configure a Windows install for a Gecko app to properly let Windows know how to pin shortcuts.
{{ Bug("549641") }} Firefox raises alarm (in error console) about SSL servers being vulnerable to CVE-2009-3555 4 Trivial   All this is is adding a note to the docs that you can disable this warning using a preference.
{{ Bug("587734") }} Integrate lazy window console API into WebConsole code 4   Sheppy This is a placeholder for web console API docs. HUDService.jsm needs to be documented.
{{ Bug("595934") }} Some xpconnect and Chrome errors should be displayed in the web console 4     The core issue here is documented; this is currently a placeholder for needing a better reference to the categories somewhere. Probably should be migrated into a new bug.
{{ Bug("585709") }} Several pages related to Accessibility under MDN (MDC) has broken/outdated links or information 4 Easy  

Does not fit in dev-doc-needed+RESOLVED but probably useful to list here anyway.

A lot of the accessibility information mentioned in this bug is well out of date.
{{ Bug("323810") }} [FIXr]Move forcing into tabs and current windows out of Gecko> 5 Large   For docs, see comment 13 and comment 14. The patch is very large and will take a while to go through to make sure nothing's missed. Mostly of interest to embedders, who tend to read the source anyway.
{{ Bug("431503") }} Create infrastructure to test processing of key events with different keyboard layouts 5 Easy   Basically adds a single method to nsIDOMWindowUtils to let you programmatically inject keyboard events for testing. Only accessible from privileged code.
{{ Bug("480735") }} Startup timeline 5 Easy   Only seriously deep core devs and testers will use it. Adds new API for logging during app startup.
{{ Bug("507711") }} (callgraph) Produce mozilla-wide callgraph for static analyses 5     This is very important and useful to a very small number of people. We need to update our docs to provide information about where to get the callgraph generated by this project. There's initial documentation at https://developer.mozilla.org/en/Callgraph that need to be gone over to be sure it's current.
{{ Bug("533592") }} Get rid of xpcnativewrappers=no 5 Easy   There are notes on the "XPCOM changes in Gecko 2" page on this. xpcnativewrappers=no is a really really old old old feature, it had been deprecated for years when it was removed. The migration guide is "You must learn XPCWrappedNatives". Need to purge all mention of xpcnativewrappers=no except the place that says it's gone.
{{ Bug("568728") }} Move nsAddonRepository.js to a JSM 5     Need to document the AddOnRepository JS code module. Double-check: This is core, rather than something typical devs will use.
{{ Bug("571970") }} Main browser chrome should be hidden when viewing in-content UI 5 Trivial   This is simply a single new attribute on XUL windows that says that chrome should be disabled. Used only in very limited cases. Only works in browser windows, not general windows.

Doc completed

When you have finished documentation work for a bug, at the very least, please change the "dev-doc-needed" keyword to "dev-doc-complete". Then please also remove the row from the bug in the table above. If you want to celebrate completing the doc work, you can also paste the row to the table below, and change the "Doc Scope" value to the date you completed the work (this keeps the number of columns the same for easy pasting).

Bug ID Title Doc Priority Date Doc Completed Doc Owner Notes
{{ Bug("617097") }} JavaScript toLocaleString has a nasty memory leak High 2010-12-10 Sheppy Document that the localeToUnicode callback shouldn't free the buffer it's given.
{{ Bug("512424") }} implement IAccessibleTable2   2010-12-13 Trevor Use Trevor's API doc add-on to create interface reference docs (doesn't need more than that).
{{ Bug("616733") }} disable and/or remove WebSockets for gecko 2.0 due to security problems High 2010-12-13 Sheppy Document that it's disabled by default, and how to turn it on (at own risk). Point to the spec until further notice. See also {{ Bug("472529") }}
{{ Bug("614015") }} Add <browser>.messageManager property 1 2010-12-20 Sheppy New property.
{{ Bug("412819") }} Mechanism for changing an extension GUID via updates 1 2010-12-20 Sheppy

Used by Add-on developers. Basically changes the new Addon Manager API to let an extension being installed automatically uninstall an old one, so that an add-on that's changing its GUID can get rid of the old version automatically.

{{ Bug("574924") }} TM: implement remaining wrappers 1  2010-12-20  Sheppy See comment 19. Xray wrappers show up in the console, so need to document what they mean. E.g.: [object XrayWrapper [object blah]] means you won't be able to see expandos or document.forms.blah

Revision Source

<p>The following list is based on <a class=" link-https" href="https://bugzilla.mozilla.org/buglist.cgi?keywords=dev-doc-needed&amp;query_format=advanced&amp;keywords_type=allwords&amp;columnlist=assigned_to%2Cstatus_whiteboard%2Ckeywords%2Cshort_desc&amp;resolution=FIXED&amp;resolution=WORKSFORME&amp;product=Core&amp;product=Fennec&amp;product=Firefox&amp;product=NSPR&amp;product=NSS&amp;product=Tamarin&amp;product=Toolkit&amp;known_name=Updates%20Needed%20-%20Firefox%2FReady%20all%20Releases&amp;query_based_on=Updates%20Needed%20-%20Firefox%2FReady%20all%20Releases" title="https://bugzilla.mozilla.org/buglist.cgi?keywords=dev-doc-needed&amp;query_format=advanced&amp;keywords_type=allwords&amp;columnlist=assigned_to,status_whiteboard,keywords,short_desc&amp;resolution=FIXED&amp;resolution=WORKSFORME&amp;product=Core&amp;product=Fennec&amp;product=Firefox&amp;product=NSPR&amp;product=NSS&amp;product=Tamarin&amp;product=Toolkit&amp;known_name=Updates Needed - Firefox/Ready all Releases&amp;query_based_on=Updates Needed - Firefox/Ready all Releases">dev-doc-needed+RESOLVED</a> Bugzilla query. However, this list is manually maintained, and therefore may not be completely current. You can help by adding bugs that appear in the query but not in this list, with as much information as you can.</p>
<p>If you decide to work on one of these bugs, please add your name to the Doc Owner cell for that bug.</p>
<p>If you have questions about the documentation effort for any particular bug, you can add a comment to the bug, or ask in #devmo on irc.mozilla.org or the <a class=" link-mailto" href="mailto:dev-mdc@lists.mozilla.org" rel="freelink">dev-mdc@lists.mozilla.org</a> mailing list.</p>
<h2>Doc needed</h2>
<p>Doc priority is on a scale from 1-5, where 1 is "OMG URGENT!!1!" and 5 is "meh."</p>
<table border="0" cellpadding="1" cellspacing="1" class="standard-table"> <thead> <tr> <th scope="col">Bug ID</th> <th scope="col">Title</th> <th scope="col">Doc Priority</th> <th scope="col">Doc Scope</th> <th scope="col">Doc Owner</th> <th scope="col">Notes</th> </tr> </thead> <tbody> <tr> <td>{{ Bug("435041") }}</td> <td>implement Cocoa NPAPI event model for Mac OS X</td> <td>1</td> <td>Large</td> <td> </td> <td>Massive update to the plugin developer docs for Mac OS X. To support 64-bit plugins, plugin developers need to switch to this new event model.</td> </tr> <tr> <td>{{ Bug("472529") }}</td> <td>(websocket) Support for Web sockets' HTML5 Draft Recommendation</td> <td>1</td> <td>Large</td> <td> </td> <td>On hold pending spec changes. See {{ Bug("616733") }}</td> </tr> <tr> <td>{{ Bug("501423") }}</td> <td>StorageEvent implementation does not match the spec</td> <td>1</td> <td> </td> <td> </td> <td>Needs to be done for Fx4. Update StorageEvent docs to match implementation (and spec).</td> </tr> <tr> <td>{{ Bug("546590") }}</td> <td>(harmony:proxies) Implement Harmony Proxies [ES6?]</td> <td>1</td> <td>Hard</td> <td> </td> <td> <p>Brendan Eich recently did a presentation on this (<a class=" external" href="http://www.slideshare.net/BrendanEich/metaprog-5303821%29">http://www.slideshare.net/BrendanEich/metaprog-5303821)</a>. See also <a class=" external" href="http://wiki.ecmascript.org/doku.php?id=harmony:proxies">http://wiki.ecmascript.org/doku.php?id=harmony:proxies</a></p> jorendorff to provide examples: "Proxies are just like __noSuchMethod__, times a million. * __noSuchMethod__ only goes to work after a method isn't found. Proxy hooks, instead, fire right away, completely replacing the normal method/property lookup."</td> </tr> <tr> <td>{{ Bug("553413") }}</td> <td>(async-IndexedDB) Implement Asynchronous parts of the Indexed Database API</td> <td>1</td> <td> </td> <td>Janet</td> <td>On hold waiting for spec to settle. This is a placeholder for IndexedDB doc work.</td> </tr> <tr> <td>{{ Bug("579178") }}</td> <td>Don't enumerate components/*.manifest and chrome/*.manifest</td> <td>1</td> <td> </td> <td> </td> <td>See comments 30 and 31.</td> </tr> <tr> <td>{{ Bug("587931") }}</td> <td>Add support for document.currentScript and script-started script-ended events</td> <td>1</td> <td> </td> <td> </td> <td>Docs have been written, but aren't quite useful. See comment 20.</td> </tr> <tr> <td>{{ Bug("59314") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">Alerts should be content-modal, not window-modal</span></span></td> <td>2</td> <td> </td> <td>Sheppy</td> <td>Actively working, should be done soon (as of 2010-12-09)</td> </tr> <tr> <td>{{ Bug("368835") }}</td> <td>No focus events from xul tree table when a row is deleted</td> <td>2</td> <td> </td> <td> </td> <td>Need better docs of tree-related events.</td> </tr> <tr> <td>{{ Bug("398776") }}</td> <td>(doorhanger) want mechanism for site-specific notification</td> <td>2</td> <td> </td> <td> </td> <td>New API for creating doorhanger notifications. Needs sample code (based on tests?) and screenshots.</td> </tr> <tr> <td>{{ Bug("407963") }}</td> <td>[FUEL] Factor out generic toolkit aspects of FUEL into a reusable form</td> <td>2</td> <td> </td> <td> </td> <td>FUEL is an abstraction layer between extensions and interfaces. Doc work may be done, or may be incomplete. Need to compare the state of the docs and the state of the code.</td> </tr> <tr> <td>{{ Bug("460882") }}</td> <td>setTimeout loses XPCNativeWrappers</td> <td>2</td> <td>Small</td> <td> </td> <td>Need to find all the places to mention it. Need to check whether the API change is already documented.</td> </tr> <tr> <td>{{ Bug("511761") }}</td> <td>Only use compatibility.ini (not .autoreg, or stat()s) to invalidate fastloads and other caches</td> <td>2</td> <td>Unknown</td> <td> </td> <td>See comments 43 and 54. Needs to be scoped. Pretty deep voodoo sounding stuff.</td> </tr> <tr> <td>{{ Bug("513162") }}</td> <td>[Windows] Drawing in the Title Bar for the New Firefox Theme</td> <td>2</td> <td>Trivial</td> <td> </td> <td>See comment 164; despite the huge bug ticket, the doc change is very minor.</td> </tr> <tr> <td>{{ Bug("517580") }}</td> <td>Make JS_HAS_GETTER_SETTER always 1, remove support for old-style getters and setters</td> <td>2</td> <td>Easy</td> <td> </td> <td> <p>Waldo blogged about this: <a class=" external" href="http://whereswalden.com/2010/04/16/more-spidermonkey-changes-ancient-esoteric-very-rarely-used-syntax-for-creating-getters-and-setters-is-being-removed/">http://whereswalden.com/2010/04/16/more-spidermonkey-changes-ancient-esoteric-very-rarely-used-syntax-for-creating-getters-and-setters-is-being-removed/</a></p> Waldo says: could summarize as "various non-standard syntaxes for defining getters and setters have been removed; syntax defined by ES5 has not been touched". There aren't any newly-obsolete functions.</td> </tr> <tr> <td>{{ Bug("520696") }}</td> <td>Implement support for |{ get "string literal"() { /* ... */ }, get 5.4() { /* ... */ }, 6.72: 3 }|</td> <td>2</td> <td>Probably easy</td> <td> </td> <td>Looks scarier than it probably is. Need to update <a href="/../../../../en/JavaScript/Guide/Values,_Variables,_and_Literals#Literals" title="../../../../en/JavaScript/Guide/Values,_Variables,_and_Literals#Literals">https://developer.mozilla.org/en/JavaScript/Guide/Values,_Variables,_and_Literals#Literals</a>. Plus wherever we have reference docs that apply.</td> </tr> <tr> <td>{{ Bug("536472") }}</td> <td>ES5: { get x(v) { } } and { set x(v, v2) { } } should be syntax errors</td> <td>2</td> <td>Easy</td> <td> </td> <td>This sounds like it may be a simple matter of a note in the ES5 page that says that this syntax is checked correctly now. And make sure that any changes that might be needed are made to <a href="/../../../../en/JavaScript/Reference/Operators/Special/get" title="../../../../en/JavaScript/Reference/Operators/Special/get">https://developer.mozilla.org/en/JavaScript/Reference/Operators/Special/get</a> and the corresponding set page.</td> </tr> <tr> <td>{{ Bug("537873") }}</td> <td>Assignment to readonly properties should throw a TypeError in strict mode</td> <td>2</td> <td>Trivial</td> <td> </td> <td>Need to note that strict mode now throws a TypeError in strict mode instead of silently failing if you try to change readonly properties. As usual, need to double check to be sure that if the old behavior is specifically mentioned anywhere, we update it.</td> </tr> <tr> <td>{{ Bug("542406") }}</td> <td>readonly="true" doesn't work on fields</td> <td>2</td> <td>Easy</td> <td> </td> <td>Just need to fix docs that were put in the wrong place.</td> </tr> <tr> <td>{{ Bug("543444") }}</td> <td>Replace single-view API with multiple observers</td> <td>2</td> <td>Moderate</td> <td> </td> <td>The interface references are updated for this, but the sample code and how-to guide mentioned in comment 38 need updating. Might be able to extract info from tests. Follow up with Marco re example code.</td> </tr> <tr> <td>{{ Bug("543910") }}</td> <td>[Windows] Improve Windows OS theme detection for Firefox.next</td> <td>2</td> <td>Easy</td> <td> </td> <td>New media query that lets you detect which theme is being used on Windows (for theme authors).</td> </tr> <tr> <td>{{ Bug("595937") }}</td> <td>Need support for customizing toolbars which are outside of the toolbox</td> <td>2</td> <td>Easy</td> <td> </td> <td>An API to let you indicate which toolbox a toolbar should be associated with if it's not actually contained within the toolbox.</td> </tr> <tr> <td>{{ Bug("599693") }}</td> <td>Allow developers to run mochitest-1 ... mochitest-5 by simply specifying those as a make target</td> <td>2</td> <td>Easy</td> <td> </td> <td>An addition to the QA and build docs to say you can do make mochitest-X to run tests.</td> </tr> <tr> <td>{{ Bug("264308") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">Implement DOM Level 3 UserData API</span></span></td> <td>3</td> <td> </td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">Old bug, needs someone to figure out how it works. The spec is not very helpful. Needs to be scoped. Might need its own doc bug.</span></td> </tr> <tr> <td>{{ Bug("321169") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">XUL templates need better logging capability</span></span></td> <td>3</td> <td> </td> <td> </td> <td>Basically should amount to "how do you turn on and off logging of XUL templates". Add a link to <a href="/../../../../en/XUL/Template_Guide" title="../../../../en/XUL/Template_Guide">https://developer.mozilla.org/en/XUL/Template_Guide</a> for a "Debugging XUL templates" page.</td> </tr> <tr> <td>{{ Bug("391829") }}</td> <td>Add support for container-live-role to object attributes</td> <td>3</td> <td>Easy</td> <td> </td> <td>Add container-live-role to <a href="/.php?title=en/AJAX/WAI_ARIA_Live_Regions%2F%2FAPI_Support" title=".php?title=en/AJAX/WAI_ARIA_Live_Regions%2F%2FAPI_Support">https://developer.mozilla.org/index.php?title=en/AJAX/WAI_ARIA_Live_Regions%2F%2FAPI_Support</a> (is Ajax the correct topic here?)</td> </tr> <tr> <td>{{ Bug("399537") }}</td> <td>XPIDL documentation needs to be migrated and overhauled</td> <td>3</td> <td> </td> <td> </td> <td>XPIDL is the language used when creating IDL files to define interfaces. Newcomers to the project need to know this.</td> </tr> <tr> <td>{{ Bug("433616") }}</td> <td>[FIX]Need facility for managing documents referenced via local URI references</td> <td>3</td> <td>Large</td> <td> </td> <td>Needs research (probably more research than writing). Need to identify everything that gains cross-server support because of this change and update the relevant docs.</td> </tr> <tr> <td>{{ Bug("451729") }}</td> <td>Allow runtime's security callbacks to be overridden by a context</td> <td>3</td> <td> </td> <td> </td> <td>JS runtime docs changes. May have been started by jorendorff; unclear if it's finished.</td> </tr> <tr> <td>{{ Bug("501925") }}</td> <td>Change cookie policy to relax the mailnews-specific APP_TYPE_MAIL requirement</td> <td>3</td> <td>Unknown</td> <td> </td> <td>Thunderbird-specific. Needs scoping.</td> </tr> <tr> <td>{{ Bug("507012") }}</td> <td>Need an efficient and convenient execution tracing API for profiling</td> <td>3</td> <td>Easy</td> <td> </td> <td>This will make it much easier for extension developers to find and fix their performance problems. API change for the JS runtime that lets you profile JS routines using a callback that gets run on function enter and exit. Should also get mentioned on the "Improving your extension's performance" page we need to write.</td> </tr> <tr> <td>{{ Bug("529404") }}</td> <td>Assignments to a property that has a getter but not a setter should only throw a TypeError in strict mode</td> <td>3</td> <td>Easy</td> <td> </td> <td>Blogged at <a class=" external" href="http://whereswalden.com/2009/12/21/ecma-262-ed-5-backwards-incompatible-change-coming-to-spidermonkey-and-to-gecko-based-browsers/">http://whereswalden.com/2009/12/21/ecma-262-ed-5-backwards-incompatible-change-coming-to-spidermonkey-and-to-gecko-based-browsers/</a> (per comment 11). Need to track down all the places where it needs to be mentioned, both in the JS reference and in the JS guide, as well as in "New in JavaScript 1.8.5" and the ECMAScript 5 docs.</td> </tr> <tr> <td>{{ Bug("541373") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">Provide a global VACUUM component</span></span></td> <td>3</td> <td> </td> <td>Marco Bonardo [:mak] ?</td> <td>The reference docs are written for this, but we could use an example for how to use it added.(Need to follow up with Marco re additional doc he was going to do.)</td> </tr> <tr> <td>{{ Bug("562446") }}</td> <td>ES5: array functions don't work on non-arrays</td> <td>3</td> <td> </td> <td> </td> <td>Update the JS reference pages on array functions (toString, toSource, toLocaleString), plus add notes to the ES5 page and possibly changes to the JS guide.</td> </tr> <tr> <td>{{ Bug("568863") }}</td> <td>Performance measurement utility</td> <td>3</td> <td>Easy</td> <td> </td> <td>This is partially documented already: <a href="/../../../../en/JavaScript_code_modules/PerfMeasurement.jsm" title="../../../../en/JavaScript_code_modules/PerfMeasurement.jsm">https://developer.mozilla.org/en/JavaScript_code_modules/PerfMeasurement.jsm</a> Needs to be adapted into reference docs for the code module. (Should be easy based on existing info) Link to this from the TBD extension performance article.</td> </tr> <tr> <td>{{ Bug("573588") }}</td> <td>Implement Desktop Notifications</td> <td>3</td> <td> </td> <td> </td> <td>This is a new API for letting content create notifications to the user (a la Growl on the Mac). Update navigator.mozNotification doc. Example code and screenshots for various platforms would be nice.</td> </tr> <tr> <td>{{ Bug("427293") }}</td> <td>"Secure Connection Failed" makes it difficult to work in the web hosting industry</td> <td>4</td> <td>Small</td> <td> </td> <td>At most, this is documenting a preference that most users won't touch. Start a list of "super secret use-at-your-own-risk" preferences?</td> </tr> <tr> <td>{{ Bug("494345") }}</td> <td>Do not create accessibles for XUL label or description having a role of 'presentation'</td> <td>4</td> <td>Easy</td> <td> </td> <td>Small API change. Should only take minutes.</td> </tr> <tr> <td>{{ Bug("501490") }}</td> <td>Enable Taskbar Previews for Windows 7</td> <td>4</td> <td> </td> <td> </td> <td>Reference stuff is mostly written, might need updating. To do: Make sure interface docs are up to date, then try to get a sample working.</td> </tr> <tr> <td>{{ Bug("514120") }}</td> <td>Style resolution shows up as a serious cost when wrapping DOM nodes that have no frames</td> <td>4</td> <td>Moderate</td> <td> </td> <td>This is a simple note that needs to be made, but figuring out where to put it will take some research.</td> </tr> <tr> <td>{{ Bug("521141") }}</td> <td>Start menu / programs shortcuts pinned to the taskbar don't group correctly</td> <td>4</td> <td>Probably easy</td> <td> </td> <td>Good for someone familiar with the Windows installation process. This is about how to configure a Windows install for a Gecko app to properly let Windows know how to pin shortcuts.</td> </tr> <tr> <td>{{ Bug("549641") }}</td> <td>Firefox raises alarm (in error console) about SSL servers being vulnerable to <a class=" external" href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2009-3555">CVE-2009-3555</a></td> <td>4</td> <td>Trivial</td> <td> </td> <td>All this is is adding a note to the docs that you can disable this warning using a preference.</td> </tr> <tr> <td>{{ Bug("587734") }}</td> <td>Integrate lazy window console API into WebConsole code</td> <td>4</td> <td> </td> <td>Sheppy</td> <td>This is a placeholder for web console API docs. HUDService.jsm needs to be documented.</td> </tr> <tr> <td>{{ Bug("595934") }}</td> <td>Some xpconnect and Chrome errors should be displayed in the web console</td> <td>4</td> <td> </td> <td> </td> <td>The core issue here is documented; this is currently a placeholder for needing a better reference to the categories somewhere. Probably should be migrated into a new bug.</td> </tr> <tr> <td>{{ Bug("585709") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">Several pages related to Accessibility under MDN (MDC) has broken/outdated links or information</span></span></td> <td>4</td> <td>Easy</td> <td> </td> <td> <p>Does not fit in <a class=" link-https" href="https://bugzilla.mozilla.org/buglist.cgi?keywords=dev-doc-needed&amp;query_format=advanced&amp;keywords_type=allwords&amp;columnlist=assigned_to%2Cstatus_whiteboard%2Ckeywords%2Cshort_desc&amp;resolution=FIXED&amp;resolution=WORKSFORME&amp;product=Core&amp;product=Fennec&amp;product=Firefox&amp;product=NSPR&amp;product=NSS&amp;product=Tamarin&amp;product=Toolkit&amp;known_name=Updates%20Needed%20-%20Firefox%2FReady%20all%20Releases&amp;query_based_on=Updates%20Needed%20-%20Firefox%2FReady%20all%20Releases" title="https://bugzilla.mozilla.org/buglist.cgi?keywords=dev-doc-needed&amp;query_format=advanced&amp;keywords_type=allwords&amp;columnlist=assigned_to,status_whiteboard,keywords,short_desc&amp;resolution=FIXED&amp;resolution=WORKSFORME&amp;product=Core&amp;product=Fennec&amp;product=Firefox&amp;product=NSPR&amp;product=NSS&amp;product=Tamarin&amp;product=Toolkit&amp;known_name=Updates Needed - Firefox/Ready all Releases&amp;query_based_on=Updates Needed - Firefox/Ready all Releases">dev-doc-needed+RESOLVED</a> but probably useful to list here anyway.</p> A lot of the accessibility information mentioned in this bug is well out of date.</td> </tr> <tr> <td>{{ Bug("323810") }}</td> <td>[FIXr]Move forcing into tabs and current windows out of Gecko&gt;</td> <td>5</td> <td>Large</td> <td> </td> <td>For docs, see comment 13 and comment 14. The patch is very large and will take a while to go through to make sure nothing's missed. Mostly of interest to embedders, who tend to read the source anyway.</td> </tr> <tr> <td>{{ Bug("431503") }}</td> <td>Create infrastructure to test processing of key events with different keyboard layouts</td> <td>5</td> <td>Easy</td> <td> </td> <td>Basically adds a single method to nsIDOMWindowUtils to let you programmatically inject keyboard events for testing. Only accessible from privileged code.</td> </tr> <tr> <td>{{ Bug("480735") }}</td> <td>Startup timeline</td> <td>5</td> <td>Easy</td> <td> </td> <td>Only seriously deep core devs and testers will use it. Adds new API for logging during app startup.</td> </tr> <tr> <td>{{ Bug("507711") }}</td> <td>(callgraph) Produce mozilla-wide callgraph for static analyses</td> <td>5</td> <td> </td> <td> </td> <td>This is very important and useful to a very small number of people. We need to update our docs to provide information about where to get the callgraph generated by this project. There's initial documentation at <a href="/../../../../en/Callgraph" title="../../../../en/Callgraph">https://developer.mozilla.org/en/Callgraph</a> that need to be gone over to be sure it's current.</td> </tr> <tr> <td>{{ Bug("533592") }}</td> <td>Get rid of xpcnativewrappers=no</td> <td>5</td> <td>Easy</td> <td> </td> <td>There are notes on the "XPCOM changes in Gecko 2" page on this. xpcnativewrappers=no is a really really old old old feature, it had been deprecated for years when it was removed. The migration guide is "You must learn XPCWrappedNatives". Need to purge all mention of xpcnativewrappers=no except the place that says it's gone.</td> </tr> <tr> <td>{{ Bug("568728") }}</td> <td>Move nsAddonRepository.js to a JSM</td> <td>5</td> <td> </td> <td> </td> <td>Need to document the AddOnRepository JS code module. Double-check: This is core, rather than something typical devs will use.</td> </tr> <tr> <td>{{ Bug("571970") }}</td> <td>Main browser chrome should be hidden when viewing in-content UI</td> <td>5</td> <td>Trivial</td> <td> </td> <td>This is simply a single new attribute on XUL windows that says that chrome should be disabled. Used only in very limited cases. Only works in browser windows, not general windows.</td> </tr> </tbody>
</table>
<h2>Doc completed</h2>
<p>When you have finished documentation work for a bug, at the very least, please change the "dev-doc-needed" keyword to "dev-doc-complete". Then please also remove the row from the bug in the table above. If you want to celebrate completing the doc work, you can also paste the row to the table below, and change the "Doc Scope" value to the date you completed the work (this keeps the number of columns the same for easy pasting).</p>
<table cellpadding="1" cellspacing="1" class="standard-table"> <thead> <tr> <th scope="col">Bug ID</th> <th scope="col">Title</th> <th scope="col">Doc Priority</th> <th scope="col">Date Doc Completed</th> <th scope="col">Doc Owner</th> <th scope="col">Notes</th> </tr> </thead> <tbody> <tr> <td>{{ Bug("617097") }}</td> <td>JavaScript toLocaleString has a nasty memory leak</td> <td>High</td> <td>2010-12-10</td> <td>Sheppy</td> <td>Document that the localeToUnicode callback shouldn't free the buffer it's given.</td> </tr> <tr> <td>{{ Bug("512424") }}</td> <td>implement IAccessibleTable2</td> <td> </td> <td>2010-12-13</td> <td>Trevor</td> <td>Use Trevor's API doc add-on to create interface reference docs (doesn't need more than that).</td> </tr> <tr> <td>{{ Bug("616733") }}</td> <td>disable and/or remove WebSockets for gecko 2.0 due to security problems</td> <td>High</td> <td>2010-12-13</td> <td>Sheppy</td> <td>Document that it's disabled by default, and how to turn it on (at own risk). Point to the spec until further notice. See also {{ Bug("472529") }}</td> </tr> <tr> <td>{{ Bug("614015") }}</td> <td>Add &lt;browser&gt;.messageManager property</td> <td>1</td> <td>2010-12-20</td> <td>Sheppy</td> <td>New property.</td> </tr> <tr> <td>{{ Bug("412819") }}</td> <td>Mechanism for changing an extension GUID via updates</td> <td>1</td> <td>2010-12-20</td> <td>Sheppy</td> <td> <p>Used by Add-on developers. Basically changes the new Addon Manager API to let an extension being installed automatically uninstall an old one, so that an add-on that's changing its GUID can get rid of the old version automatically.</p> </td> </tr> <tr> <td>{{ Bug("574924") }}</td> <td>TM: implement remaining wrappers</td> <td>1</td> <td> 2010-12-20</td> <td> Sheppy</td> <td>See comment 19. Xray wrappers show up in the console, so need to document what they mean. E.g.: [object XrayWrapper [object blah]] means you won't be able to see expandos or document.forms.blah</td> </tr> </tbody>
</table>
Revert to this revision