Saros Developer Documentation

Saros Team

This work is licensed under the Creative Commons Attribution License. To view a copy of this license, visit http://creativecommons.org/licenses/by/3.0/ or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA.


Table of Contents

1. Introduction
Overview
About this manual
2. Rules
Code Rules
Review Rules
3. Installing and Configuring Plugins
Installing the SVN Plugin
Installation of Subclipse (textual)
Installation of Subclipse (graphical)
Installing the Git Plugin
Installation of EGit (textual)
Installation of EGit (graphical)
Known issues
Installing the JTourbus Plugin
Installation of JTourBus (textual)
Installation of JTourBus (graphical)
4. Sourcecode and Review
Version Control with Git
Introduction to Git
Git clone with EGit (textual)
Git clone with EGit (graphical)
Configuring Git for Gerrit
Creating an SSH key
Setting your name and email address
Register on Gerrit
Signing up using OpenID
Making a review
Submitting a change
Summary
System Overview
5. Making changes to Saros
Cleaning your working copy
Reverting local modifications
Deleting untracked/new files
Downloading a change
Downloading a change (textual)
Downloading a change (graphical)
Doing your first change
The first change (textual)
The first change (graphical)
Understanding build failures
Dealing with feedback
Updating your changes
Fetch, Rebase and Push
Advanced Git Topics
Cherry-pick
Staging Changes
Tasks during a release
Pushing to a non default branch (textual)
Pushing to a non default branch (graphical)
6. Patterns and Anti-Patterns
Anti-Patterns
PicoContainer usage
Use Interfaces
Splitting Work
...
7. Configuration of Gerrit
Grant push access to Gerrit
Granting +2/-2 and the right to submit
Granting branch creation

List of Figures

4.1. Code, Review and Test workflow

List of Tables

5.1. Destination Reference