Steps for Developers

Install EGit into your Eclipse IDE or use your favorite Git client (You can use the Install New Software feature in Eclipse to install from the Juno repository)

Before the official freeze date (TBD, tentatively April 30), test that you can connect to the test repositories (see below) with your needed level of access.

Committers should try making a commit and push to the test repositories to again verify your needed access

Before the official freeze date, make all outstanding commits to the SVN repository

After the SVN freeze date and migration is complete, create a new workspace or remove the SVN-linked STEM projects from your existing workspace then clone and checkout STEM from the new Git repositories

Repository Layout

Due to the nature of distributed versioning system like Git, an entire repository must be "cloned" onto a developer's machine before it can be worked with. While Git's compression is impressive, it still requires significant network transfer time and local storage for large repositories - even if you only need to work with a small subset. In STEM's case, we store a large amount of denominator in our SVN repository, on the order of 2 GB.

STEM has will split our code base into multiple repositories that can be fetched independently as needed. The proposed repositories are:

The idea is you can work independently with STEM without needing the additional repositories and they can be added as needed (although most developers will benefit from having the org.eclipse.stem.data repository cloned).

In July 2011, STEM did a logical refactor that changed the layout of our SVN repository from a flat to hierarchical structure reflecting components. We're happy with this layout and will not be changing the overall structure of our repository.

Checking out STEM into Eclipse using EGit

To quickly checkout the required STEM source code, the project set generator has been updated to generate EGit-compatible Team Project set.

In Eclipse, open the Git Repository Exploring perspective

Launch the Project Set Import Wizard File > Import > Team > Team Project Set