Skip to content
Akila Ravihansa Perera edited this page Feb 27, 2014 · 21 revisions

Recommended Git Flow

All Sahana Vesuvius source code is managed by git, and hosted on GitHub under Sahana organizational account. Not only is GitHub used to host the source code, but also to facilitate collaboration via forks and pull requests. Sahana Vesuvius contributors are expected to follow the GitHub flow.

Fork The Sahana Vesuvius Repository

If you've not used GitHub before:

  1. Sign-up for an account on GitHub
  2. Set up git on you your computer by following these instructions.
  • Note: In order to contribute code back to the Eden project, you need to "push" your changes to GitHub, and GitHub requires you to authenticate for that. The instructions describe authenticating using a password. If you don't want to do do that, you can use SSH keys instead. For more information, see links below.
  • For Windows users
  • For Linux users
  • Generating SSH keys

Get your own copy of the Vesuvius repository on both GitHub and your local machine:

  1. Fork the Eden repository at: https://github.com/sahana/vesuvius
  2. Use git to clone your own new fork down to your PC, as follows:
cd web2py/applications
git clone [email protected]:mygitusername/eden.git
cd eden
git remote add upstream git://github.com/flavour/eden.git
Clone this wiki locally