Source branches

From Second Life Wiki
Revision as of 22:58, 2 May 2007 by Rob Linden (talk | contribs)
Jump to navigation Jump to search

Though Linden Lab doesn't provide a public version control repository, it's useful to understand how Linden Lab deals with branches for understanding the code drops above.

We generally have four major branches at all times, along with many development branches:

  • Numbered branch (currently "Branch_1-15-0") - this is where the current release resides, and where very minor fixes get checked in for the next minor release (e.g., if 1.15.0.2 is the last release, then changes for 1.15.0.3 would get checked in here).
  • "release" - the main trunk of development. This is often referred to as "head" or "trunk" in other organizations. We are rather conservative about what gets checked into release, though, preferring that development work mainly happens on branches (either a dedicated feature branch, or "maintenance" for the small stuff, and only gets merged into release once QA has happened. We aspire to keep release compatible with the agni (main) grid. All branches occasionally pick up changes from release, and are occassionally merged back into release.
  • "release-candidate" - when we're working toward a major release, this branch provides a similar function to release, but is for changes that are compatible with the beta grid (usually aditi) rather than the release grid
  • "maintenance" - bug fixes and small features that don't warrant their own branch get checked into maintenance. Changes from maintenance are periodically merged up to release and release-candidate after QA has tested a build from the branch. Many source code contributions from the community land in this branch first.

Other branches are typically branched from release or release candidate.

Linden Lab does feature development on independent branches. As those features mature, they are merged into the "release-candidate" branch. The QA group tests the feature, and either reject or approve it for inclusion in "release". When a major release is about to happen, a branch is created for work on that release (e.g. "Branch_1-13-2"), which gets synced with the "release" branch periodically. Then, stability work is done on the branch, and the new code is deployed. After that, any stability work gets merged back into "release", and the process repeats for the next major release. In the meantime, stability work continues on the branch for maintenance releases.

Note that the dated releases (e.g. 20070117a) are sourced from the working trunk (the "release" branch), and the numbered releases (e.g. 1.13.2.xx) are to sync with the official viewer releases. This means that often, but not always, the dated releases are newer.

Branching model.png