DOM Inspector/Releases/Checklist

This is a snapshot of the page, documenting a future process. Some things will not work with the current state of the DOM Inspector repository.

DOM Inspector release day

DOM Inspector releases are prepared from a release branch. Get there by doing updating to the branch point of the latest branch, then updating the working directory to the tip of the branch:

 $ hg update DOMI_LATEST_BRANCH && hg update

From there the release process is as follows:

• Verify that the maxVersion strings in install.rdf on the release branch for all applications match the versions that correspond to the current nightlies derived from mozilla-central. (This shouldn't be necessary if you've already done everything you're supposed to do on the last merge day.)
• Change the makefile to reflect the new version number. Use the tracking bug for that release in your commit.
  • e.g., when releasing DOMi 2.0.12, you would change it from 2.0.12pre to 2.0.12 on the DOMI_2_0_12 branch. The commit message would be "Bug 738048 - (DOMi2.0.12) DOM Inspector 2.0.12". See changeset c42fd9baba56.
• Add a version-specific tag and a DOMI_LATEST_RELEASE tag
  • e.g.,
    $ hg tag DOMI_2_0_12_RELEASE
    $ hg tag -r DOMI_2_0_12_RELEASE DOMI_LATEST_RELEASE
• Build it
  • Download the latest mozilla-central release source drop
    • e.g., get it from ftp://ftp.mozilla.org/pub/firefox/releases/latest/source
    • This should work with other, non-Firefox mozilla-central project source drops since we're not actually going to build the application; we're just going to leverage the mozilla build system. It's just that the Firefox ftp directory includes a "latest" symlink, and others don't.
  • Extract the source drop
    • e.g.,
      :~/src$ tar xjf ./firefox-12.0.source.tar.bz2
  • Drop dom-inspector into the extensions directory
    • Clone the repo there:
      :~/src/mozilla-release$ hg clone http://hg.mozilla.org/dom-inspector ./extensions/inspector
    • Update to the release branch:
      :~/src/mozilla-release$ hg update -R ./extensions/inspector DOMI_LATEST_RELEASE
    • Alternatively, you can mv/cp/hg archive the repository you were working from before, but I usually clone a new one for good measure, since the dom-inspector repo is so small.
  • Edit the .mozconfig to enable DOM Inspector in the build (and nothing else):
    ac_add_options --enable-application=extensions
    ac_add_options --enable-extensions=inspector
  • Start the build:
    :~/src/mozilla-release$ make -f ./client.mk
  • Fish out the XPI from $MOZOBJDIR/dist/xpi-stage
    • e.g., ~/src/mozilla-release/objdir-i686-pc-linux-gnu/dist/xpi-stage/inspector-2.0.12.xpi
• Prepare the release notes
  • find the dependent bugs for release bug
    • e.g., bug DOMi2.0.12
    • it's easy to copy and paste if you look at the dependency tree for the bug, at max depth 1, showing resolved
      • e.g., https://bugzilla.mozilla.org/showdependencytree.cgi?id=738048&maxdepth=1&hide_resolved=0
    • Ignore the tracking bug for the previous release; don't copy it into the release notes.
  • The notes take this form:
<ul>
  <li>
    <a href="URL"
       title="Bug bug id - bug summary">Bug bug id</a>&nbsp;- bug summary (patch by contributor)
  </li>
</ul>

Localization fixes:
<ul>
  <li>Language: Contributor</li>
</ul>

  • feel free to add explanatory text or additional prose above or below the notes
• Submit it to AMO
  • Paste the release notes
  • Ping someone in #addons for review
• Leave a comment in the release bug about the AMO status
• RESOLVE the bug when it gets reviewed and is made available on AMO