Developing with the OPF

h2. Overview

One of the main goals of the Open Planets Foundation is to <b>SUPPORT</b> the development of&nbsp;maintainable "turn-key" digital preservation software.

To this extent we recommend that a simplistic well utilised strategy be employed when developing software, keeping use of many disparate services to a minimum where possible.&nbsp;

The Open Planets Foundation recommends using GitHub to manage source code control and to provide the following features:
* To put the software description and README
* To manage your source code
* To manage branches and tags
* To manage releases and packaging code
* To keep track of issues relating to the code
* To manage a roadmap via the issue tracker

To add information to the wiki or to our issue tracker, you need an OPF Labs account.&nbsp;To develop with the OPF, you need to set up two accounts, one for github and one for the OPF Labs site.

* To join github, sign-up here:&nbsp;[https://github.com/signup/free|https://github.com/signup/free]
* To join OPF Labs, sign-up here:&nbsp;[http://jira.opf-labs.org/secure/Signup...|http://jira.opf-labs.org/secure/Signup\!default.jspa]
* After you've done this, let web-admin (&nbsp;a t )&nbsp;openplanetsfoundation.org know your username(s), and he will add you to the appropriate groups so that you have the permissions you need.

h2. OPF Labs Resources

The OPF development environment consists of:

* Code repositories on github:&nbsp;[https://github.com/openplanets]\*\* The Planets code will be archived on [SourceForge|http://sourceforge.net/projects/planets-suite/], but this is a 'backup' and not the development environment.
* OPF Labs development infrastructure:
** The wikis:&nbsp;[http://wiki.opf-labs.org/]
** Continuous build integration with Bamboo:&nbsp;[http://bamboo.opf-labs.org/][http://bamboo.opf-labs.org/]
** FishEye code inspection and review:&nbsp;{color:#006daf}\[{color}{color:#006daf}[http://fisheye.opf-labs.org/]{color}\|http://fisheye.opf-labs.org/\]

* Mailing lists and downloads are hosted in a number of places.
** e.g. Planets developers should join [https://lists.sourceforge.net/lists/listinfo/planets-suite-developers|https://lists.sourceforge.net/lists/listinfo/planets-suite-developers]


h2. Setting up git

* GitHub have this set-up help: [http://help.github.com/set-up-git-redirect]\*\* e.g. for Windows: [http://help.github.com/win-set-up-git/]

h3. Further help

* For help setting up git and github, see [http://help.github.com/]\*\* see also this nice HTML5 git cheatsheet [http://www.ndpsoftware.com/git-cheatsheet.html]
* If you use Eclipse, the egit plugin is pretty good:&nbsp;[http://www.eclipse.org/egit/]\*\* Here's a tutorial on how to use it: [http://www.vogella.de/articles/EGit/article.html]
* If you use Windows, the tortoisegit shell integration is quite good: [http://code.google.com/p/tortoisegit/]
* [OPF Labs front page|KB:Home]
* [Planets Suite Wiki|PT:Planets Suite Components]