Getting Source

CloudStack uses git for source version control, if you know little about git, http://book.git-scm.com/ is a good start. Once you have git setup on your machine, pull source with:

git clone https://git-wip-us.apache.org/repos/asf/incubator-cloudstack.git
+git clone https://git-wip-us.apache.org/repos/asf/cloudstack.git
 
 
 

Modified: websites/staging/cloudstack/trunk/content/develop/non-contributors.html
==============================================================================
--- websites/staging/cloudstack/trunk/content/develop/non-contributors.html (original)
+++ websites/staging/cloudstack/trunk/content/develop/non-contributors.html Thu Mar 21 15:34:19 2013
@@ -114,7 +114,7 @@

Contributing to Apache CloudStack as a Non-Committer

If you're a committer on an Apache project, it means that you can commit directly to the project's repository. For instance, with Apache CloudStack (incubating) committers are allowed to directly push commits into the git repository.

If you're a committer on an Apache project, it means that you can commit directly to the project's repository. For instance, with Apache CloudStack committers are allowed to directly push commits into the git repository.

Non-committers, however, have to submit patches for review. Don't worry, it's not an onerous process at all. The first time you submit a patch, it will take a minute or two to create an account on Review Board, but it's a piece of cake from start to finish.

Assumptions

For the purpose of this post, we'll assume that you already have a system with Git and have found a bug to fix or have a feature that you'd like to submit, and you're willing to contribute that code or documentation under the Apache License 2.0.

@@ -126,13 +126,13 @@

git config --global user.name "Your Name"

git config --global user.email you@domain.com

You'll grab the CloudStack source with git:

$ git clone https://git-wip-us.apache.org/repos/asf/incubator-cloudstack.git

$ git clone https://git-wip-us.apache.org/repos/asf/cloudstack.git

If you already have the source, make sure you're working with the most recent version. Do a git pull if you cloned the source more than a few hours ago. (Apache CloudStack development can move pretty fast!)

Now that you have an up-to-date copy of the source, create a branch to do your work in:

$ git checkout -b mybranch

This does two things: One, it creates the branch mybranch and two, it changes your working branch to mybranch. Running git branch will show you which branch you're working on, with an asterisk next to the active branch, like so:

-[user@localhost incubator-cloudstack]$ git branch
+[user@localhost cloudstack]$ git branch
   master
 * mybranch