Setup GitHub

In order to develop code for the inspectIT a contributor needs to apply the following development process:

GitHub Setup

A prerequisite to work on inspectIT is that a contributor needs to have a working GitHub account. Please use the https://github.com/join page to create an account if you don't have one.

Once the account has been created, you should create a SSH key that you will use on the GitHub. Detailed information on creating the key can be found at https://help.github.com/articles/generating-ssh-keys/.

Fork inspectIT project on the GitHub

First thing a contributor need to do is fork the official inspectIT repository on the GitHub. Each contributor of inspectIT has his own forked repository that serves for pushing the code changes a contributor developed. The official inspectIT repository is located at https://github.com/inspectIT/inspectIT. In the top right corner you will see the ability to fork the repository. Note that you must have a user on GitHub and be logged-in to perform this action.

Use oomph installer to get the source code

After the fork has been created, a contributor should setup a local development environment. This can be done by going through the steps described for the oomph installation: Development Environment

After this is finished, add your own forked repository as a new remote to your local git repository:

git remote add <username> git@github.com:<username>/inspectIT.git

Note that username should be replaced with your correct user-name from GitHub account. You can also copy the SSH clone URL from the forked repository page:

To keep your local copy up-to-date, you're advised to fetch remote changes as often as possible to rebase your personal work on top of it:

git fetch origin
git rebase origin/stable

To understand why we enforce rebase and do not allow any merge commits to appear please visit this blog post.