Firefox3/Documentation Plan: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
No edit summary
(update some statuses)
 
(45 intermediate revisions by 4 users not shown)
Line 9: Line 9:
Note that the estimated work hours is just that: an estimate.
Note that the estimated work hours is just that: an estimate.


We will soon be creating landing pages for web and extension developers to learn how to update their content for Firefox 3.  These will be targeted to ramp up well in advance of the expected beta release of Firefox 3 in July.
We will soon be creating landing pages for web and extension developers to learn how to update their content for Firefox 3.  These will be targeted to ramp up well in advance of the expected beta release of Firefox 3 in <s>July</s> October (?).
 
Some items to document that may not be on this page are tracked in bugzilla:
* [https://bugzilla.mozilla.org/buglist.cgi?quicksearch=ALL+dev-doc-needed dev-doc-needed bugs] (these need to be documented; 33 bugs as of 2007-10-16)
* [https://bugzilla.mozilla.org/buglist.cgi?quicksearch=ALL+dev-doc-complete dev-doc-complete bugs] (documentation for these has been created; 60 bugs as of 2007-10-16)


{| class="standard-table"
{| class="standard-table"
Line 20: Line 24:
|class="header"|ETA
|class="header"|ETA
|-
|-
|-
|- style="background-color:#F0FFF0;"
|Content Handling
|Web-based content handlers
|sheppy
|done
|[http://wiki.mozilla.org/Firefox3/ContentManagement:Handlers Notes]
|6
|- style="background-color:#F0FFF0;"
|Web Apps 1.0
|Web Apps 1.0
|<code>&lt;a ping&gt;</code>
|<code>&lt;a ping&gt;</code>
|
|sheppy
|
|done
|{{bug|319368}}, [http://www.whatwg.org/specs/web-apps/current-work/#ping specification]; this may not actually ship in Fx3.
|{{bug|319368}}, [http://www.whatwg.org/specs/web-apps/current-work/#ping specification]
|2
|2
|- style="background-color:#F0FFF0;"
|- style="background-color:#F0FFF0;"
Line 34: Line 45:
|
|
|
|
|-
|- style="background-color:#F0FFF0;"
|Offline resources
|Offline resources
|Offline resources
|Still in design phase; can't make estimates until design more or less done
|done
|
|{{bug|367447}}, {{bug|372969}}, {{bug|372970}}, {{bug|373231}}, and [http://www.whatwg.org/specs/web-apps/current-work/#alternate-style-sheets specification]
|
|{{bug|367447}} and [http://www.whatwg.org/specs/web-apps/current-work/#alternate-style-sheets specification]
|?
|?
|-
|- style="background-color:#F0FFF0;"
|Web Apps 1.0
|Web Apps 1.0
|API for alternate style sheets
|API for alternative style sheets
|
|sheppy
|
|done
|{{bug|200930}}, [http://www.whatwg.org/specs/web-apps/current-work/#alternate-style-sheets specification]
|{{bug|200930}}, [http://www.whatwg.org/specs/web-apps/current-work/#alternate-style-sheets specification]
|100
|100
Line 55: Line 65:
|
|
|
|
|-
|- style="background-color:#F0FFF0;"
|Web Apps 1.0
|Web Apps 1.0
|Canvas <code>transform()</code> and <code>setTransform()</code>
|Canvas <code>transform()</code> and <code>setTransform()</code>
|mfinkle
|mfinkle
|
|done enough
|
|[https://bugzilla.mozilla.org/show_bug.cgi?id=357450 bug 357450], [http://whatwg.org/specs/web-apps/current-work/#transform specification]
|4
|- style="background-color:#F0FFF0;"
|Web Apps 1.0
|<code>contentEditable</code> support
|mfinkle
|done
|[http://www.whatwg.org/specs/web-apps/current-work/#contenteditable1 specification]
|4
|4
|- style="background-color:#F0FFF0;"
|- style="background-color:#F0FFF0;"
Line 71: Line 88:
|- style="background-color:#F0FFF0;"
|- style="background-color:#F0FFF0;"
|CSS
|CSS
|<code>[[mdc:CSS:font-size_adjust|font-size-adjust]]</code> works on all platforms
|<code>[[mdc:CSS:font-size-adjust|font-size-adjust]]</code> works on all platforms
|sheppy
|sheppy
|done
|done
|
|
|0
|0
|-
|- style="background-color:#F0FFF0;"
|CSS
|CSS
|<code>rgba()</code> and <code>hsla()</code> color value support
|<code>rgba()</code> and <code>hsla()</code> [[mdc:CSS:color|color value support]]
|sheppy
|sheppy
|
|done
|See {{bug|147017}}.
|See {{bug|147017}}.
|8
|8
|-
|- style="background-color:#F0FFF0;"
|CSS
|CSS
|<code>:default</code> pseudo-class support
|<code>:default</code> pseudo-class support
|sheppy
|sheppy
|
|done; someone confirm the sample is valid though please
|Need to read bug {{bug|302186}}.
|Need to read bug {{bug|302186}}.
|2
|2
|-
|- style="background-color:#F0FFF0;"
|CSS
|CSS
| -moz-intrinsic, -moz-min-intrinsic, -moz-shrink-wrap, and -moz-fill values have been added to width, min-width, and max-width ({{bug|311415}}).
| -moz-intrinsic, -moz-min-intrinsic, -moz-shrink-wrap, and -moz-fill values have been added to width, min-width, and max-width ({{bug|311415}}).
|sheppy
|sheppy
|
|done
|{{bug|311415}}
|{{bug|311415}}
|4
|4
Line 104: Line 121:
|
|
|0
|0
|-
|- style="background-color:#F0FFF0;"
|DOM
|DOM
|<code>[[mdc:DOM:element.getClientRects|getClientRects]]</code> and <code>[[mdc:DOM:element.getBoundingClientRect|getBoundingClientRect]]</code> extensions support
|<code>[[mdc:DOM:element.getClientRects|getClientRects]]</code> and <code>[[mdc:DOM:element.getBoundingClientRect|getBoundingClientRect]]</code> extensions support
|sheppy
|done
|
|
|2
|-
|FUEL
|The FUEL library has reference docs but needs how-to guides
|mfinkle
|
|
|
|
|2
|?
|-
|-
|JavaScript
|JavaScript
|[[mdc:New in JavaScript 1.8|JavaScript 1.8]]
|[[mdc:New in JavaScript 1.8|JavaScript 1.8]]
|jresig
|jresig
|Just a list of what's coming so far.
|The stuff that's already implemented is documented.
|{{bug|380236}}
|{{bug|380236}}
|?
|?
|-
|- style="background-color:#F0FFF0;"
|XSLT/XPath
|XSLT/XPath
|<code>node-set()</code> (from common) support
|Support for [[mdc:EXSLT|EXSLT]].
|
|sheppy
|
|done
|{{bug|193678}}, [http://www.exslt.org/exsl/functions/node-set/index.html specification]
|{{bug|193678}}, [http://www.exslt.org/exsl/functions/node-set/index.html specification]
|8
|8
|-
|- style="background-color:#F0FFF0;"
|XSLT/XPath
|Regular expressions support
|
|
|{{bug|354886}}, [http://www.exslt.org/regexp/index.html specification]
|20
|-
|SVG
|SVG
|<code>foreignObject</code>
|<code>foreignObject</code>
Line 139: Line 156:
|{{bug|326966}}, [http://www.w3.org/TR/SVG11/extend.html#ForeignObjectElement specification], [http://weblogs.mozillazine.org/roc/archives/2006/06/the_future_is_now.html see also]
|{{bug|326966}}, [http://www.w3.org/TR/SVG11/extend.html#ForeignObjectElement specification], [http://weblogs.mozillazine.org/roc/archives/2006/06/the_future_is_now.html see also]
|4
|4
|-
|- style="background-color:#F0FFF0;"
|SVG
|SVG
|<code>pattern</code> element
|<code>pattern</code> element
|
|sheppy
|
|done
|[http://www.w3.org/TR/SVG11/pservers.html#PatternElement specification]
|[http://www.w3.org/TR/SVG11/pservers.html#PatternElement specification]
|14
|1
|-
|- style="background-color:#F0FFF0;"
|SVG
|SVG
|<code>mask</code> element
|<code>mask</code> element
|
|sheppy
|
|done
|[http://www.w3.org/TR/SVG11/masking.html#MaskElement specification]
|[http://www.w3.org/TR/SVG11/masking.html#MaskElement specification]
|14
|1
|-
|- style="background-color:#F0FFF0;"
|SVG
|SVG
|SVG filters: filter, feBlend, feComponentTransfer, feFuncR, feFuncG, feFuncB, feFuncA, feComposite, feFlood, feGaussianBlur, feMerge, feMergeNode, feMorphology, feOffset, feTurbulence
|SVG filters: filter, feBlend, feComponentTransfer, feFuncR, feFuncG, feFuncB, feFuncA, feComposite, feFlood, feGaussianBlur, feMerge, feMergeNode, feMorphology, feOffset, feTurbulence
|
|sheppy
|
|done
|[http://www.w3.org/TR/SVG11/filters.html specification]
|[http://www.w3.org/TR/SVG11/filters.html specification]
|24
|24
|-
|- style="background-color:#F0FFF0;"
|SVG
|SVG
|<code>&lt;a&gt;</code> element became <code>nsSVGAElement</code> instead of XML binding
|<code>&lt;a&gt;</code> element became <code>nsSVGAElement</code> instead of XML binding
|sheppy
|done
|This just needed to be mentioned as a bug fix in the Fx3 for developers page.
|
|
|
|- style="background-color:#F0FFF0;"
|
|
|-
|SVG
|SVG
|Various DOM functions for text have been implemented
|Various DOM functions for text have been implemented
|sheppy
|done
|We don't actually have on-MDC docs for SVG specifics, but the Fx3 for developers page now lists the newly-implemented methods.
|
|
|
|- style="background-color:#F0FFF0;"
|
|
|-
|XUL
|XUL
|<code>&lt;[[mdc:XUL:scale|scale]]&gt;</code>
|<code>&lt;[[mdc:XUL:scale|scale]]&gt;</code>
Line 181: Line 198:
|
|
|1
|1
|-
|- style="background-color:#F0FFF0;"
|XUL
|XUL
|<code>[[mdc:XUL:Attribute:textbox.type|number]]</code> boxes
|<code>[[mdc:XUL:Attribute:textbox.type|number]]</code> boxes
Line 188: Line 205:
|
|
|1
|1
|-
|- style="background-color:#F0FFF0;"
|XUL
|XUL
|<code>&lt;dropmarker&gt;</code> element
|<code>&lt;dropmarker&gt;</code> element
|mfinkle
|mfinkle
|
|done
|{{bug|348614}}
|{{bug|348614}}
|4
|4
|-
|- style="background-color:#F0FFF0;"
|XUL
|XUL
|<code>&lt;spinbuttons&gt;</code> element
|<code>&lt;spinbuttons&gt;</code> element
|mfinkle
|mfinkle
|
|done
|{{bug|155053}}
|{{bug|155053}}
|4
|4
|-
|- style="background-color:#F0FFF0;"
|XUL
|XUL
|<code>&lt;[[mdc:XUL:datepicker|datepicker]]&gt;</code> element
|<code>&lt;[[mdc:XUL:datepicker|datepicker]]&gt;</code> element
Line 209: Line 226:
|[http://wiki.mozilla.org/XUL:Specs:DateTimePickers specification]
|[http://wiki.mozilla.org/XUL:Specs:DateTimePickers specification]
|4
|4
|-
|- style="background-color:#F0FFF0;"
|XUL
|XUL
|<code>&lt;[[mdc:XUL:timepicker|timepicker]]&gt;</code> element
|<code>&lt;[[mdc:XUL:timepicker|timepicker]]&gt;</code> element
Line 216: Line 233:
|[http://wiki.mozilla.org/XUL:Specs:DateTimePickers specification]
|[http://wiki.mozilla.org/XUL:Specs:DateTimePickers specification]
|4
|4
|-
|- style="background-color:#F0FFF0;"
|XUL
|XUL
|Tree improvements
|Tree improvements
|
|sheppy
|
|done
|{{bug|212789}}, {{bug|296040}}, {{bug|201499}}, [[XUL:Tree]]
|{{bug|212789}}, {{bug|296040}} (done), {{bug|201499}} (done), [[XUL:Tree]]
|8
|8
|-
|- style="background-color:#F0FFF0;"
|XUL
|XUL
|Menu improvements
|Menu improvements
|?
|various
|?
|done
|{{bug|333023}}, {{bug|372552}}, {{bug|312867}}, {{bug|312867}}, {{bug|70798}}
|{{bug|333023}}, {{bug|372552}}, {{bug|70798}} (done)
|8
|8
|-
|- style="background-color:#F0FFF0;"
|XUL
|XUL
|Textbox improvements
|Textbox improvements
|?
|sheppy
|?
|done
|{{bug|346787}}, {{bug|312867}}, {{bug|312867}}, {{bug|253481}}
|{{bug|346787}}, {{bug|312867}}, {{bug|253481}}
|4
|4
|-
|- style="background-color:#F0FFF0;"
|XUL
|XUL
|Buttons may be made repeatable
|Buttons may be made repeatable
|?
|mfinkle
|?
|done
|{{bug|331055}}
|{{bug|331055}}
|2
|2
|-
|- style="background-color:#F0FFF0;"
|XUL
|XUL
|<code>buttondisabledaccept</code> may now be used on <code>&lt;dialog&gt;</code> elements to have the OK button initially disabled
|<code>[[mdc:XUL:Attribute:buttondisabledaccept|buttondisabledaccept]]</code> may now be used on <code>&lt;dialog&gt;</code> elements to have the OK button initially disabled
|?
|sheppy
|
|done
|{{bug|247849}}
|{{bug|247849}}
|2
|2
|-
|- style="background-color:#F0FFF0;"
|XUL
|XUL
|Title bars now have an <code>allowevents</code> attribute
|Title bars now have an <code>allowevents</code> attribute
|?
|?
|
|none needed; just a bug fix
|{{bug|361425}}
|{{bug|361425}}
|1
|1
|-
|- style="background-color:#F0FFF0;"
|XUL
|XUL
|Splitters now have a "both" option for collapse
|Splitters now have a "both" option for collapse
|?
|?
|
|done
|{{bug|337955}}
|{{bug|337955}}
|1
|1
|-
|- style="background-color:#F0FFF0;"
|XUL
|XUL
|Rich list boxes now support multiple selection
|Rich list boxes now support multiple selection
|?
|sheppy
|
|done
|Set <code>seltype</code> to <code>multiple</code> to allow it
|Set <code>seltype</code> to <code>multiple</code> to allow it
|4
|4
Line 283: Line 300:
|The new <code>[[mdc:nsIIdleService|nsIIdleService]]</code>
|The new <code>[[mdc:nsIIdleService|nsIIdleService]]</code>
|sheppy
|sheppy
|needs sample, otherwise done
|Needs to be twiddled into our preferred format for interface docs, but content is done
|
|
|?
|?
|-
|- style="background-color:#F0FFF0;"
|Assorted
|Assorted
|Assorted bugs have been fixed; see [[mdc:Firefox 3 for developers|Firefox 3 for developers]] for details
|Assorted bugs have been fixed; see [[mdc:Firefox 3 for developers|Firefox 3 for developers]] for details
|?
|?
|done
|
|
|
|
|
|- style="background-color:#F0FFF0;"
|-
|Places
|Places
|Needs documenting in full
|Needs documenting in full
|?
|various
|?
|done
|[[Places]], [http://dietrich.ganx4.com/mozilla/places-erd.png Schema]
|[[Places]], [http://dietrich.ganx4.com/mozilla/places-erd.png Schema]
|160
|160
Line 307: Line 324:
|[http://blog.mozilla.com/dolske/2007/05/28/followup-password-manager-changes-coming-in-ff3-alpha-5/ this blog post].
|[http://blog.mozilla.com/dolske/2007/05/28/followup-password-manager-changes-coming-in-ff3-alpha-5/ this blog post].
|8
|8
|-
|- style="background-color:#F0FFF0;"
|Cycle Collector
|Cycle Collector
|New and needs docs.
|New and needs docs.
|sheppy
|done?
|See [[mdc:Interfacing with the XPCOM cycle collector]].  {{bug|333078}}
|?
|?
|?
|- style="background-color:#F0FFF0;"
|See [[Interfacing with the XPCOM cycle collector]] and [[Global nsICycleCollector service]] for initial docs.  {{bug|333078}}
|?
|-
|Download Manager
|Download Manager
|Several changes to document.
|Several changes to document.
|?
|sheppy
|?
|done
|See {{bug|380250}}, {{bug|289540}}, [http://shawnwilsher.com/archives/100 blog post].
|See {{bug|380250}}, {{bug|289540}}, [http://shawnwilsher.com/archives/100 blog post].
|?
|?

Latest revision as of 15:45, 2 April 2008

This page provides information on the plans for documenting Firefox 3, including listing topics that need to be covered, specific articles that need to be written, and the names of people that have expressed an interest in covering them. All topics are expected to include examples; note their status as well.

In addition, rough (very rough) estimates of how long various tasks should take are included.

See Firefox 3 for developers and Gecko 1.9 Changes affecting websites for additional details, including links to bugs and specifications.

If you're working on one of these documents, please indicate in the "ETA" column the amount of time (in hours) you expect the work to take to complete.

Note that the estimated work hours is just that: an estimate.

We will soon be creating landing pages for web and extension developers to learn how to update their content for Firefox 3. These will be targeted to ramp up well in advance of the expected beta release of Firefox 3 in July October (?).

Some items to document that may not be on this page are tracked in bugzilla:

Category Topic Lead Writer Status Notes ETA
Content Handling Web-based content handlers sheppy done Notes 6
Web Apps 1.0 <a ping> sheppy done bug 319368, specification 2
Web Apps 1.0 WHATWG online/offline devents jresig done
Offline resources Offline resources done bug 367447, bug 372969, bug 372970, bug 373231, and specification ?
Web Apps 1.0 API for alternative style sheets sheppy done bug 200930, specification 100
Web Apps 1.0 getElementsByClassName() jresig done
Web Apps 1.0 Canvas transform() and setTransform() mfinkle done enough bug 357450, specification 4
Web Apps 1.0 contentEditable support mfinkle done specification 4
CSS display property's inline-block and inline-table values are now implemented sheppy done 0
CSS font-size-adjust works on all platforms sheppy done 0
CSS rgba() and hsla() color value support sheppy done See bug 147017. 8
CSS :default pseudo-class support sheppy done; someone confirm the sample is valid though please Need to read bug bug 302186. 2
CSS -moz-intrinsic, -moz-min-intrinsic, -moz-shrink-wrap, and -moz-fill values have been added to width, min-width, and max-width (bug 311415). sheppy done bug 311415 4
DOM clientTop and clientLeft extensions support done 0
DOM getClientRects and getBoundingClientRect extensions support sheppy done 2
FUEL The FUEL library has reference docs but needs how-to guides mfinkle ?
JavaScript JavaScript 1.8 jresig The stuff that's already implemented is documented. bug 380236 ?
XSLT/XPath Support for EXSLT. sheppy done bug 193678, specification 8
SVG foreignObject mfinkle done bug 326966, specification, see also 4
SVG pattern element sheppy done specification 1
SVG mask element sheppy done specification 1
SVG SVG filters: filter, feBlend, feComponentTransfer, feFuncR, feFuncG, feFuncB, feFuncA, feComposite, feFlood, feGaussianBlur, feMerge, feMergeNode, feMorphology, feOffset, feTurbulence sheppy done specification 24
SVG <a> element became nsSVGAElement instead of XML binding sheppy done This just needed to be mentioned as a bug fix in the Fx3 for developers page.
SVG Various DOM functions for text have been implemented sheppy done We don't actually have on-MDC docs for SVG specifics, but the Fx3 for developers page now lists the newly-implemented methods.
XUL <scale> mfinkle done 1
XUL number boxes mfinkle done 1
XUL <dropmarker> element mfinkle done bug 348614 4
XUL <spinbuttons> element mfinkle done bug 155053 4
XUL <datepicker> element mfinkle done specification 4
XUL <timepicker> element mfinkle done specification 4
XUL Tree improvements sheppy done bug 212789, bug 296040 (done), bug 201499 (done), XUL:Tree 8
XUL Menu improvements various done bug 333023, bug 372552, bug 70798 (done) 8
XUL Textbox improvements sheppy done bug 346787, bug 312867, bug 253481 4
XUL Buttons may be made repeatable mfinkle done bug 331055 2
XUL buttondisabledaccept may now be used on <dialog> elements to have the OK button initially disabled sheppy done bug 247849 2
XUL Title bars now have an allowevents attribute ? none needed; just a bug fix bug 361425 1
XUL Splitters now have a "both" option for collapse ? done bug 337955 1
XUL Rich list boxes now support multiple selection sheppy done Set seltype to multiple to allow it 4
Templates Templates have been improved in several ways mfinkle ? bug 285631, more info
Idle service The new nsIIdleService sheppy Needs to be twiddled into our preferred format for interface docs, but content is done ?
Assorted Assorted bugs have been fixed; see Firefox 3 for developers for details ? done
Places Needs documenting in full various done Places, Schema 160
Login Manager Rewritten; API changes; formerly Password Manager sheppy done this blog post. 8
Cycle Collector New and needs docs. sheppy done? See mdc:Interfacing with the XPCOM cycle collector. bug 333078 ?
Download Manager Several changes to document. sheppy done See bug 380250, bug 289540, blog post. ?

Additional resources

Retrieved from "https://wiki.allizom.org/index.php?title=Firefox3/Documentation_Plan&oldid=88936"