I'm Jennifer Zickerman. I am working on the Thunderbird documentation, auditing and organizing the existing stuff, identifying gaps and finding people to help fill them. Please contact me with your ideas and suggestions.
(Trivia: In Canada, the letter "Z" is pronounced "zed". Therefore I am "jen" + "zed")
Improvements to add-on docs for Thunderbird 3 release
We need to provide better documentation so that people can write add-ons for Thunderbird. Currently, there are documents in many locations, of questionable relevance and accuracy. With this project, we will create a document set on http://developer.mozilla.org that will be the primary reference. The document structure will be organized; existing docs will be audited, updated and edited; new docs will be created to show developers how to do common tasks. (Caveat: we will prioritize a small list of common tasks and do these, and possibly create a call-to-action / template that contributors can use to add additional "how to" docs.)
April 16: finish plan (this document); submit for feedback from internal folks
April 17/18: incorporate feedback; submit for feedback from community
... final by TB 3.0 release ...
- (jen) Review existing docs
- (jen) Propose better structure / deployment
- (jen / MoMo / community) Identify gaps; prioritize
- (jen / MoMo / community) Technically validate existing articles
- (jen / MoMo / community) Write new articles to fill prioritized gaps
- (jen / MoMo / community) Update existing articles
- (jen) Implement structure / deployment plan
- (jen) Edit the whole shebang
- (jen) Add comments / notices to articles that talk about TB extensions on Mozillazine, various blogs, PlanetMoz, etc, pointing to the updated docs on MDC
- (jen) Wag tail
- What are the high-level intentions regarding developer.mozilla.org versus www.mozilla.org versus wiki.mozilla.org? Are the following statements correct:
- www.mozilla.org is gradually being retired as a developer documentation site and things are being gradually ported to developer.mozilla.org?
- www.mozilla.org will be the user documentation site?
- wiki.mozilla.org is the project management site - there probably shouldn't be any documentation here, just links?
- It seems that www.mozilla.org is used for "core" docs (instructions for build, localization, etc). Is this as desired?
Main Page (https://developer.mozilla.org/en/)
- change "Extensions" page to "Extensions / Add-ons"? (to standardize terminology) (Or is this not really a problem?)
- standardize on "addons" or "add-ons"? (I know, I know...) (already in style guide?)
- Why is "Documentation" heading a site tag?
Main Page | Extensions (https://developer.mozilla.org/en/Extensions)
I think there are enough similarities in extension development for Firefox and Thunderbird that the following documents should be "generic" - that is, a single document should cover the topic for both Firefox and Thunderbird (with application-specific sections as necessary).
- (review / make generic) Setting up extension development environment
- (review / make generic) Extension Packaging
- (review / make generic) Installing extensions ( -> Installing / Uninstalling extensions) (do we have existing uninstalling info?)
- (review / make generic) Extension Frequently Asked Questions
- (review / make generic) Submitting an add-on to AMO
- (review / make generic) Code snippets
- Firefox addons developer guide
- Creating Custom Firefox Extensions with the Mozilla Build System
- Updating extensions for Firefox 3
- Updating extensions for Firefox 3.5
- Building an Extension ( -> Building a Firefox extension)
- (review / update) Building a Thunderbird extension (developer.mozilla.org/en/Building_a_Thunderbird_extension)
- (new) Developer resources (STEEL, FUEL, GLODA)
- (new) How to muck around with the folder pane
- (new) How to muck around with the message view
- (new) How to muck around with the message list
- (new) How to add a new tab
- (new) How to add a column
(many potential topics here - Sheppie also has a list at https://developer.mozilla.org/User:Sheppy/Thunderbird_documentation_list under "Thunderbird architecture" - need to prioritize)
- Updating extensions for SeaMonkey 2.0
Tidy up our own pages; point to new / reworked stuff.
- https://wiki.mozilla.org/Thunderbird:Extensions (remove "TBD")
- "Extensions" section on http://www.mozilla.org/projects/thun...xtensions.html - point to developer.mozilla.org/en/Extensions
Email: jen at mozillamessaging dot com