# Development Workflow

Once you have everything set up it is time to start getting your hands at the code. The exact steps depend on how you have set up your development environment and your taste in things (and stuff), but here’s what you will generally want to do.

1. Set Up an Eclipse Installation

   This used to be rather hard, but thankfully people have seen that problem and started to do something about it. The result is the Oomph Eclipse Installer. The easiest way now is to go to the Eclipse Downloads page and click the prominent Download button there. Execute the installer and follow this guide (includes pictures!).

2. Find a Git Repository to Work With

   While working you will probably want to create a bunch of commits and push them to a repository. However, our installer by default simply clones our official ELK repository at GitHub, which you don’t have permission to write to. What you will want to do, thus, is to get your hands on another GitHub repository that you do have permission to write to. The best way is to simply fork our main repository by clicking the Fork link at the upper right corner of our repository page. Add your new repository as a second remote to your local clone and push your commits there.

3. Tickets

   Of course we have a list of issues. If you want to work on one of them, you should mention your intentions there to let us know that we should not start working on the issue ourselves. Also, we might have helpful input for you to think about. If you want to implement a feature that we do not have an issue for yet, open one.

4. Proper Commit Messages

   This is an example of what we consider to be a proper commit message:

       Core, Layered: Fix labels with layout directions #58

       Using node labels inside compound nodes that are configured to use
       different layout directions resulted in problems with calculated insets.

       Signed-off-by: Christoph Daniel Schulze <cds@informatik.uni-kiel.de>

   It consists of three parts:

   1. A first line that summarizes the commit. The summary starts by mentioning the general parts of the project that the commit affects, followed by a summary and a reference to the issue the commit is associated with. If there is no such issue, you can of course omit that.

   2. An optional paragraph (separated from the first line by a blank line) that provides more information, if necessary.

   3. A sign-off, preceded by a blank line. This is your name followed by the e-mail address that belongs to your Eclipse.org account. The sign-off is important. With this, you confirm that to the best of your knowledge your commit complies with the Certificate of Origin that you promised to honor when you signed the Eclipse ECA.

5. Contributing Your Code

   To actually contribute your code to the ELK project, go to our pull requests page and click New pull request. Since you want us to pull in changes from your fork, click the Compare across forks link and select the branch that contains the relevant changes. We will then review your code. Chances are that we will reject your pull request on your first try and ask you to make some changes. Don’t let that discourage you (also, we try to be nice about it). Simply make the changes and create another pull request.

- Tool Developers
- Graph Data Structure
- Coordinate System
- Layout Options
- JSON Format
- ELK Text Format
- Using Algorithms Directly
- Using Plain Java Layout
- Using Eclipse Layout
- Connecting to ELK
- Advanced Configuration
- Layout View Support
- Dependency Injection
- Algorithm Developers
- Getting Eclipse Ready
- Creating a New Project
- ELK Metadata Language
- Automatic Builds
- Algorithm Implementation
- Structuring Algorithms
- Algorithm Debugging
- Unit Tests
- ELK Contributors
- Development Setup
- Development Workflow
- Installing With Oomph
- Building ELK