The team of people required to create the initial release of a piece of software may vary in size from one person to several thousand people. Depending on the requirements, the challenges involved, both technical and managerial, can be immense. As explained in the Bazaar User Guide, selecting “just right” processes and using tools like Bazaar to support matching workflows can greatly help.
Success with software though requires more than a great team - it requires a healthy, active community. This group is typically far larger than the team as it includes everyone interested in the software: the team, users, training partners, support partners, third-party developers and so on.
Great communities are well understood in the free software community. Their applicability extends well beyond that though: most successful commercial software vendors are well skilled at building and managing the communities that grow up around their flagship products.
Like great teams, great communities don’t just happen. Good policies and guidelines are essential for fostering the right sort of behaviour and healthy relationships between participants. For a deeper look at this topic, see Karl Fogel’s landmark book: Producing Open Source Software.
An intelligent toolset is also important for tracking and managing community information and workflows. These tools are called Collaborative Development Environments (CDEs). These toolsets are typically web-based and manage things such as announcements, issues/bugs, questions and answers, downloads, documents and source code. Some examples of CDEs include Launchpad, SourceForge, java.net and SAP Community Network.
As well as sponsoring Ubuntu and Bazaar development, Canonical provides Launchpad, <https://launchpad.net/>, as a free service for the community. Launchpad is one of the most exciting CDEs around for several notable reasons:
In other words, Launchpad has been designed to help your community grow and to reduce the workflow friction both within your community and between communities. Ultimately, that means less time on mechanical tasks and more time for interesting development.
This tutorial looks at how Bazaar and Launchpad can be used together and how they complement each other. It is important to remember that:
By design though, their sum is greater than the individual parts.
While there are many advantages in adopting distributed version control, one of the things that disappears is the all-knowing central server with knowledge about all available branches. Indeed in a distributed environment, interesting branches can literally exist in 100s of locations across the Internet (or within an Intranet for that matter).
Launchpad fills this gap by providing a registry of branches.
Branches can be uploaded to Launchpad or simply registered as being available in an external location. Branches can also be given a Status such as New, Development, Mature or Abandoned.
Note: External branches can even be hosted in legacy version control tools, i.e. CVS and Subversion. Code in these systems will be scanned and converted to Bazaar branches on a periodic basis. For maximum fidelity of course, it is preferable for external branches to be hosted in Bazaar.
Branches can be listed, filtered and sorted by numerous attributes including Name, Registrant, Author, Status, Age and time of last commit. Browsing of branches is also provided making it easy to see things such as:
As Launchpad keeps track of thousands of projects and their latest code whether it be managed by Bazaar, CVS or Subversion, Bazaar users can grab that code as easily as this:
bzr branch lp:project-name
where project-name is the Launchpad project ID. Here are some examples:
bzr branch lp:inkscape bzr branch lp:amarok bzr branch lp:python bzr branch lp:rails bzr branch lp:java-gnome
You can then browse the code locally using your favorite editor or IDE and change the code if you wish.
If a project has multiple series registered (e.g. a development series and a maintenance series), the latest code for a given series can be fetched using:
bzr branch lp:project-name/series
Having fixed that annoying bug or added that cool feature you’ve always wanted, it’s time to impress your friends and make the world a better place by making your code available to others. As explained earlier, Launchpad is a free Bazaar code hosting service so you can push your branch to it and others can access your code from there. For example, assuming you are a member of the relevant team, login to launchpad like this:
bzr launchpad-login userid
where userid is your Launchpad user ID. You can then push your changes to a team branch like this:
bzr push lp:~team-name/project-name/branch-name
Others can then download your code like this:
bzr branch lp:~team-name/project-name/branch-name
Even if you are not a member of a team, Launchpad can be used to publish your changes. In this case, simply create a personal branch like this:
bzr push lp:~userid/project-name/branch-name
Others can then download your code like this:
bzr branch lp:~userid/project-name/branch-name
Note: Even when publishing to a personal branch, it is polite to notify the upstream developers about your branch so they can pull your changes from it if they are generally applicable to all users and meet the project’s quality standards.
When maintaining packages for Ubuntu using Bazaar you can easily access the package’s source branch on Launchpad. The package’s source branch in the current (default) series can be downloaded like this:
bzr branch ubuntu:package
where package is the name of the Ubuntu package you want to access. To download the package branch for a specific series in Ubuntu (e.g. Maverick or Lucid), use this:
bzr branch ubuntu:maverick/package
Ubuntu distroseries can also be abbreviated to just their first letter. For example, the above could also be written:
bzr branch ubuntu:m/package
You can also download the package source branch from Launchpad for several Debian series. The default series can be downloaded like this:
bzr branch debianlp:package
and a specific series can be downloaded like this:
bzr branch debianlp:lenny/package
Note that the debianlp: scheme access the Debian source branch for a package from Launchpad only.
Once a branch has been developed and published, communities typically go through a rigorous process before those changes are integrated into the core product and rolled out to end users. Some of the steps involved may include:
This section briefly looks at some of the features in Launchpad that help get good quality code into production. Strong integration with Bazaar is core to making this happen smoothly.
Note: Where indicated, some of the features below are still under development. If one or more of these features interest you, please consider joining the Launchpad beta test team at this link: https://help.launchpad.net/JoiningLaunchpadBetaTesters. You can then get early access to features and provide feedback to the developers before wider roll-out.
After navigating to a branch in Launchpad, one of the available actions is Propose for merging. This lets you nominate which branch this code ought to be merged into.
Tracking the knowledge about which branches are proposed to be merged into a codeline helps Release Managers keep on top of what still needs to be completed, or can be completed, before a ship date. Using this information, they can ensure branches are merged after completing any necessary reviews. In the simple case, the Release Manager may manually merge branches. In more advanced cases, the merging could be automatically done by a robot (like PQM) when the branch reaches the right state (e.g. Review completed).
A number of features are under development in Launchpad to track the states, conversations and outcomes of code reviews. These features are expected to be integrated with branch merge proposals and branch browsing features.
PPAs help developers and development teams get custom builds into the hands of users for early testing and feedback. In other words, a PPA allows a developer to form a community of testers who are interested in their changes. The testing community can install the packages, run them for the test period and then remove them cleanly from their system.
See https://help.launchpad.net/PPAQuickStart for further details.
The Translations module in Launchpad is designed to make it easy for anyone to get involved translating applications to languages they know. Translators are shielded from the low level details.
Launchpad keeps track of the translations for each major version of a project separately, allowing translators to continue to improve the translations of your stable releases while others start work on newer versions that are still in development. Translation speed in reduced by sharing resources across projects. Automatic suggestions, from a library of 750,000 translated strings, and a community of 19,000 registered translators can radically cut the time required to localise your project into many languages.
The communities we join, whether off-line or on-line, say a lot about the sort of people we are. The flip-side to this is that the tools you choose for your community - particularly the CDE and version control tool - can have a large impact on who joins and how easily they can contribute.
In their own right, Launchpad and Bazaar are highly useful tools. Together, they can:
In particular, Launchpad is a free code hosting service for your Bazaar branches, branches can be browsed online, branches can be linked to bugs and blueprints, and the status of bug-branch relationships can be automatically managed by mentioning the bug while committing in Bazaar. Further integration is under development with the aim of streamlining the process from great idea to running code in the hands of end users.
If you have any feedback on how you’d like to see Bazaar and Launchpad further integrated, please contact us on the Bazaar mailing list, email@example.com.
While designed as a free service to support free software projects, Canonical may make Launchpad available to commercial software developers depending on their requirements. We would be happy to hear from you if you think Launchpad would be useful for managing your community.