Ubuntu logo

Trophies

Recent Collectors

Trophy Information:
  • You have contributed code to a project in Launchpad
Getting Help:
  • #ubuntu-devel on Freenode

A core part of Launchpad is the ability to host different branches of code (using the Bazaar version control system) and for other people to propose improvements and changes to those branches.

What commonly happens here is that you branch the code from launchpad (for example, running bzr branch lp:the-project) and this downloads the current main branch to your computer. You then work on improvements to that branch and commit your changes using bzr commit. You then upload your changes to Launchpad using bzr push so others can see your work.

You can now propose that your branch is merged into another branch. This means that the owner of the original branch that you improved will contribute your improvements to it, this merging in your work.

This trophy is awarded when you have successfully had one of your branches merged into another branch.

How to achieve this trophy

  1. You first need to perform a Merge Proposal to propose your branch is merged into another one. Go to the Launchpad page for the branch that you uploaded and you should see a Propose For Merging link. Click it.
  2. In the form choose the branch you want to merge into and fill a detailed description of the change, fix, or feature that you have contributed.
  3. Click the Propose Merge button to submit your contribution.
  4. Wait for one of the target branch's reviewers to review your code, they will either (1) accept your code, and it will be merged, (2) modify your code slightly, and then merge it, or (3) ask for you to make some improvements before they merge it.
  5. If they request changes to be made, make the changes requested and push them into your branch. Then comment back on your proposal to say that you have made the requested changes.
  6. Now wait for the developer to review your changes. When it is merged you will get an email to inform you it was merged in.

Tips and Tricks:

  • Join the IRC channel best suited for the branch you are working on and talk to developers, they will be glad to help you.
  • Read bazaar documentation to get acquainted with it.
  • The first time you submit a branch for review, feel free to ask questions about how it works. Everyone starts somewhere!
  • Many projects have style guidelines around how their code should be laid out and written. Try to ensure your contribution meets those guidelines.

Pitfalls To Avoid:

  • If your branch is not accepted, don't be too frustrated. Ask the developer how you can improve it; often the changes required are fairly small.