Partnering/Repacks/Policy and Process

Version Control

Mozilla keeps all of our partner repack configuration files under version control in Mercurial (hg).

If you are unfamiliar with hg, Mozilla has some good dev resources for getting started:

• The basics
• Getting Mozilla Source Code Using Mercurial
• Using Mercurial

The partner-repacks repository (repo) is publicly available here: https://hg.mozilla.org/build/partner-repacks

Creating a patch

This section assumes that you are already familiar with the basics of hg.

Here is a generalized workflow:

• clone the partner-repacks repo
  • if you already have the repo, run hg pull instead
• make sure you don't have any existing changes in source clone by running hg status
• make any necessary changes to your partner repack files
  • make sure you run hg add to add new files, or hg remove if you are removing files
• commit changes to your local repository, hg commit ...
• export the changeset using hg export REV, where REV is the revision number of the changeset, e.g.:

$ PARTNERNAME=aol
$ hg export tip > repack_config_changes_for_$PARTNERNAME.diff

Submitting a patch

The best way to submit a change to an existing partner repacks is via Bugzilla.

If you're new to bugzilla, the first step is to create an account.

To expedite the bug filing process, I've created a template that partners can use to quickly file bugs under the correct product & component:

• Partner repack config change bug template

Please remember to change $PARTNERNAME in the bug summary to reflect the partner you are submitting the config change for.

Add your exported diff of changes from hg as an attachment to the bug.

By default, you will automatically receive updates for any action taken on your bug. You can change which updates you receive in your Bugzilla Preferences.

Why use Bugzilla?

Mozilla release engineering uses bugzilla to track everything. If you don't submit your patch via bugzilla, the first thing the Mozilla release engineering team does is file a bug to cover the work to be performed and attach your submitted patch/bundle.

By filing your request directly in bugzilla, you automatically notify the correct people, have a record of your patch submission, and get updates whenever some performs an action on your ticket. You save the Mozilla team manual, potentially error-prone work, and get more ongoing insight into the process and the status of your request.