Diff for "Code/QuickStart"

Not logged in - Log In / Register

Differences between revisions 8 and 9
Revision 8 as of 2009-08-04 11:06:18
Size: 2393
Editor: 92-237-59-186
Comment:
Revision 9 as of 2009-08-04 14:03:07
Size: 4740
Editor: 92-237-59-186
Comment:
Deletions are marked like this. Additions are marked like this.
Line 4: Line 4:
||<<TableOfContents(1)>>|| ||<style="font-size: 0.9em; background:#F1F1ED; padding:0.5em;"><<TableOfContents(1)>>||
Line 6: Line 6:
If you need further help, take a look at the [[Code]] section of this help wiki. '''Need more detail?''' Take a look at the [[Code]] section of this help wiki and the [[http://doc.bazaar-vcs.org/bzr.dev/en/mini-tutorial/index.html|Bazaar mini-tutorial]].
Line 11: Line 11:
First, [[Projects/Registration|add your project to Launchpad]]. On your project's overview page, click ''Change details'' towards the top-right of the page. '''Step 1:''' First, [[Projects/Registration|add your project to Launchpad]]. On your project's overview page, click ''Change details'' towards the top-right of the page.
Line 16: Line 16:
Scroll down the ''Change details'' page and select the check-box marked ''Code for this project is published in Bazaar branches on Launchpad''. '''Step 2:''' Scroll down the ''Change details'' page and select the check-box marked ''Code for this project is published in Bazaar branches on Launchpad''.
Line 21: Line 21:
Save your changes by clicking the ''Change'' button at the bottom of the page. '''Step 3:''' Save your changes by clicking the ''Change'' button at the bottom of the page.

||<tablestyle="width: 100%;" style="background-color: #2a2929; font-weight: bold; color: #f6bc05; padding: 2px 5px 2px 5px;">~-Quick tip-~||You can experiment by pushing a branch without linking it to a project. [[Code/PersonalBranches|See more about personal branches]].||
Line 26: Line 28:
 * Any Launchpad user can have a branch listed against your project  * Any Launchpad user can upload a branch and associate it with your project
Line 47: Line 49:

Once Bazaar has pushed your branch to Launchpad, Launchpad will scan the revisions in your branch and:

 * list the branch on both [[https://code.launchpad.net/people/+me|your own code overview page]] and that of the project
 * enable other people to download the branch and create their own version of it
 * make the full revision history available in the [[Loggerhead]] branch viewer.

= Set your project's trunk branch =

You can tell Launchpad which of your project's branches is the current focus of development; i.e. which is the trunk.

Setting a trunk branch is useful to:

 * tell people which branch they should download
 * define which branch Launchpad should provide when someone enters ''bzr branch lp:your-project''
 * act as the default target when someone proposes a merge.

Visit your project's code overview page and follow the link inviting you to set a development focus.

||<tablestyle="font-size: 0.8em; width:30%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;">{{attachment:set-trunk.png}}||
||<style="text-align: center;">'''Set your trunk branch'''||

== Series ==

Launchpad lets you manage multiple lines of development, which it calls series. For example: you may have a separate series each for your next major version, your current release and an older release that your still support.

You can set a development focus, or trunk, branch for each series. [[Project/SeriesMilestonesReleases|Read about series >]]

= Next steps =

You're now hosting your project's code in Launchpad. Anyone can download your code, make their changes and upload their branch for listing on your project's code page. Other people can also propose there branches for merging into your trunk, or any other branch associated with your project.

~+[[Code|Read our full guide to Launchpad Code Hosting >]]+~

Launchpad Help > Code > Quick-start

lp-diamond-16.png Code hosting quick start

Need more detail? Take a look at the Code section of this help wiki and the Bazaar mini-tutorial.

Enable code hosting for your project

Step 1: First, add your project to Launchpad. On your project's overview page, click Change details towards the top-right of the page.

change-details.png

Edit your project's info in Launchpad

Step 2: Scroll down the Change details page and select the check-box marked Code for this project is published in Bazaar branches on Launchpad.

code-for-this-project.png

Tell Launchpad you want to host your project's code here

Step 3: Save your changes by clicking the Change button at the bottom of the page.

Quick tip

You can experiment by pushing a branch without linking it to a project. See more about personal branches.

What's changed?

  • Your project overview page now reads Uses Launchpad for: Code

  • Any Launchpad user can upload a branch and associate it with your project

Push a Bazaar branch to your project

Bazaar comes with a plug-in that lets you push to and pull from Launchpad directly from within Bazaar.

To push your branch up to Launchpad, open your terminal and go to your Bazaar branch. Next up, type:

bzr push lp:~your-id/project-id/branch-name
  • ~your-id: this is your Launchpad id, which is the portion of your profile page's URL that begins with the tilde

  • project-id: the id of the project in Launchpad, which you can find at the end of your project's overview page URL

  • branch-name: whatever name you want to give to your branch, such as trunk, main or experimental

Replace project-name with your project's Launchpad id. The id is the final part of your project overview page's URL: e.g. bzr in https://launchpad.net/bzr

See your branch in place

Once Bazaar has pushed your branch to Launchpad, Launchpad will scan the revisions in your branch and:

  • list the branch on both your own code overview page and that of the project

  • enable other people to download the branch and create their own version of it
  • make the full revision history available in the Loggerhead branch viewer.

Set your project's trunk branch

You can tell Launchpad which of your project's branches is the current focus of development; i.e. which is the trunk.

Setting a trunk branch is useful to:

  • tell people which branch they should download
  • define which branch Launchpad should provide when someone enters bzr branch lp:your-project

  • act as the default target when someone proposes a merge.

Visit your project's code overview page and follow the link inviting you to set a development focus.

set-trunk.png

Set your trunk branch

Series

Launchpad lets you manage multiple lines of development, which it calls series. For example: you may have a separate series each for your next major version, your current release and an older release that your still support.

You can set a development focus, or trunk, branch for each series. Read about series >

Next steps

You're now hosting your project's code in Launchpad. Anyone can download your code, make their changes and upload their branch for listing on your project's code page. Other people can also propose there branches for merging into your trunk, or any other branch associated with your project.

Read our full guide to Launchpad Code Hosting >

Code/QuickStart (last edited 2018-05-24 17:29:52 by cjwatson)