launchpad help|
Size: 7040
Comment: work in progress
|
Size: 3393
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 2: | Line 2: |
~-[[FrontPage|Launchpad Help]] > Code -~ |
|
| Line 9: | Line 11: |
| Thousands of people have done that already, meaning that Launchpad has a huge directory of branches of code. Some people call it a [[http://news.launchpad.net/general/the-great-source-code-supermarket|code supermarket]] because it's so easy to browse and get hold of the code you want. | Thousands of people have done that already, meaning that Launchpad has a huge directory of branches of code. You could think of it as a [[http://news.launchpad.net/general/the-great-source-code-supermarket|code supermarket]] because it's so easy to browse and get hold of the code you want. |
| Line 19: | Line 21: |
| == New to Bazaar or distributed version control? == | = New to Bazaar or distributed version control? = |
| Line 30: | Line 32: |
| Instead, Bazaar lets anyone create their own branch - with full version control - of any other Bazaar branch. That gives everyone much more freedom and tears down the barriers to new and drive-by contributors. | Instead, Bazaar lets anyone create their own branch - with full version control - of any other Bazaar branch. That gives everyone much more freedom and tears down the barriers to new and drive-by contributors. When you - as the owner of the main-line branch - want to use something that appears in another branch of your project, Bazaar makes it supremely easy to merge their work into the main-line. |
| Line 32: | Line 34: |
| Also see: | |
| Line 33: | Line 36: |
| gives everyone much more freedom because anyone can create their own branch of another Bazaar branch and w checking code out of a central repository, making your changes on your local machine, and the committing your changes back to that central repository, you create For an in-depth introduction to distributed version control, see: * ''[[http://doc.bazaar-vcs.org/latest/en/mini-tutorial/index.html|Bazaar in five minutes]]'' to learn the basics of Bazaar and get set up with it on your local machine |
* ''[[http://doc.bazaar-vcs.org/latest/en/mini-tutorial/index.html|Bazaar in five minutes]]'' to learn the basics of Bazaar and set it up on your local machine |
| Line 46: | Line 39: |
| = Where Launchpad comes in = | |
| Line 47: | Line 41: |
| If you're new to distributed version control, this way of working may seem a little chaotic. Launchpad helps tie everything together by: | |
| Line 48: | Line 43: |
| Bazaar is a | * providing one place to find and download all code associated with a project, whether they're official lines of development or branches owned by anyone else * giving you free hosting for your code * linking branches of code to the [[Bugs|bug reports]] and [[Blueprint|blueprints]] that they address * offering public code review for proposed branch merges. = Next step = |
| Line 50: | Line 50: |
| Let's start by [[Code/FindingAndDownload|finding and downloading]] code using Launchpad and Bazaar. | |
| Line 51: | Line 52: |
You can also mirror or watch Bazaar branches published elsewhere on the internet and import Subversion and CVS repositories into Bazaar branches. This means that it's supremely easy to find all the code associated with a project - even casual contributions - You can use Launchpad, with the [[https://bazaar-vcs.org|Bazaar version control system]], to host branches of code and also to find and use branches of other people's code. Launchpad works with the [[https://bazaar-vcs.org|Bazaar version control system]] to provide a directory of and hosting service for free software code. As an individual, you can use Launchpad and Bazaar to: * publish, mirror and watch Bazaar branches * associate your code branches with projects * propose branch merges and take part in code review * import Subversion and CVS repositories into a Bazaar branch hosted on Launchpad * download your own version, with full revision control, of any branch of code that's tracked in Launchpad. If you run a project, and optionally associate them with a project * mirror or watch Bazaar branches published elsewhere on the internet * download your own version, with full revision control, of any branch of code that's tracked in Launchpad * import Subversion and CVS repositories into a Bazaar branch hosted on Launchpad. Launchpad is both a directory of free software code and a code hosting service. Using the [[https://bazaar-vcs.org|Bazaar version control system]] you can create your own branch of hundreds of free software projects and also Using Launchpad, you can publish branches of your code and associate them with a project. Launchpad's code hosting works closely with the [[https://bazaar-vcs.org|Bazaar version control system]] to With Launchpad, you can find source code for free software projects and also register your own branches of code to be tracked in Launchpad. Launchpad's code hosting Launchpad's code directory - or [[http://news.launchpad.net/general/the-great-source-code-supermarket|supermarket]] - Using Launchpad's code directory, you can find and host source code using the Using Launchpad, you can host code Launchpad has a code directory, or [[http://news.launchpad.net/general/the-great-source-code-supermarket|supermarket]]. Use the first two paragraphs to summarise all the important points about this article. Tell the reader if this is the information they need as soon as possible. = Instructional text = Where appropriate, use step by step instructions: '''Step 1:''' Give concise and unambiguous instructions. '''Step 2:''' Try not to state the obvious, unless you're writing for a novice user. {i} '''Note:''' Highlight important information with a note. '''Step 3:''' Use a well cropped screen shot if it will help orient the reader. Don't let the screen shot replace instructional text: not everyone can see your screen shot. Don't worry about borders or annotation for small, cropped screen shots such as this. {{attachment:screen-shot.png}} {i} '''Warning:''' If you're about to tell the reader to delete or otherwise change something that would be hard to restore, warn them. == Full screen shots == ||<tablestyle="float:right; font-size: 0.8em; width:30%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;">{{attachment:proj-announce.png}}|| ||<style="text-align: center;">'''Describe the screen shot here'''|| Some screen shots will be better placed to the right of your text. As they're not placed directly below the text that they support, use a border and short description. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam sagittis. Aliquam eros dui, scelerisque id, consequat in, accumsan vitae, pede. Suspendisse neque ligula, scelerisque ac, mattis ut, aliquam quis, odio. Proin nunc nisi, fringilla ac, congue ac, luctus eu, lacus. Maecenas ac purus. Cras felis metus, ultricies non, euismod ac, accumsan eleifend, leo. Quisque imperdiet tempus tellus. Ut euismod, diam nec adipiscing interdum, tortor orci fringilla nisi, vel blandit erat magna at nisi. Fusce hendrerit odio non metus. Mauris nisl massa, dapibus id, feugiat quis, blandit a, quam. Integer tincidunt feugiat nunc. Curabitur iaculis egestas elit. Nam imperdiet suscipit odio. |
||<tablestyle="width: 100%;"> ~-[[Translations/Groups|< Translation groups]] -~ ||<style="text-align: right;"> ~- [[Code/FindingAndDownloading|Finding and downloading code >]] -~ || |
DRAFT: this page is a work in progress. Please seek further help or check the wiki index for a complete page on this topic.
Launchpad Help > Code
Overview
Using Launchpad, you can publish Bazaar branches of your code and, optionally, associate them with projects. You can also mirror or watch Bazaar branches that are hosted elsewhere on the internet and even import Subversion and CVS repositories into Bazaar branches.
Thousands of people have done that already, meaning that Launchpad has a huge directory of branches of code. You could think of it as a code supermarket because it's so easy to browse and get hold of the code you want.
Over the next few pages, we'll look at:
- downloading and working with code that's hosted on Launchpad
- hosting your code on Launchpad
- working with a team on the same branch of code
- proposing code merges and conducting code reviews
- importing code from CVS and Subversion repositories
New to Bazaar or distributed version control?
If you're already familiar with Subversion or CVS, it's worth noting that Bazaar is a distributed version control system.
So, with Bazaar, your workflow no longer looks like this:
- jump through hoops to get read/write permission for a central code repository
- check code out of that central repository
- hack, hack, hack
- commit code back to the central repository
Instead, Bazaar lets anyone create their own branch - with full version control - of any other Bazaar branch. That gives everyone much more freedom and tears down the barriers to new and drive-by contributors. When you - as the owner of the main-line branch - want to use something that appears in another branch of your project, Bazaar makes it supremely easy to merge their work into the main-line.
Also see:
Bazaar in five minutes to learn the basics of Bazaar and set it up on your local machine
and Ian Clatworthy's excellent Distributed version control systems - why and how (PDF).
Where Launchpad comes in
If you're new to distributed version control, this way of working may seem a little chaotic. Launchpad helps tie everything together by:
- providing one place to find and download all code associated with a project, whether they're official lines of development or branches owned by anyone else
- giving you free hosting for your code
linking branches of code to the bug reports and blueprints that they address
- offering public code review for proposed branch merges.
Next step
Let's start by finding and downloading code using Launchpad and Bazaar.
