CONTRIBUTING.md

Contributing to FitNesse

This document describes some general guidelines for contributing to FitNesse. By respecting those guidelines you'll help improve FitNesse.

Submitting issues

The GitHub issues section is only for bugs and feature requests. Please refer to the mailing list or Stack Overflow for general advice. Even for possible bugs it's appreciated that they are discussed on those channels before submitting them as issues in the bug tracking system.

Bylaws for the committers of FitNesse

1. Use the FitNesse coding style.

   If you're using IntelliJ IDEA, move extra/idea/fitnesse.xml into the codestyles directory somewhere beneath IntelliJ config home. I found it on my MAC in ~/Library/Preferences/IntelijIDEA8/codestyles, or on Linux under ~/.IntelliJIdea12/config/codestyles.

   If you're using Eclipse, use extra/eclipse/fitnesse-code-formatter-eclipse.xml

   If you can't use these files in your IDE then look carefully then you can emulate any of the source files in FitNesse. Remember that indentation level is 2 spaces, and we never use tabs. Braces follow K&R style:

     void f() {
       //
     }
   

2. Never commit changes without running BOTH the unit tests AND the acceptance tests. The ant target 'all' in the build.xml file will run them both, but it's slow. I just use the IDE to run the unit tests, and then run the acceptance tests with FitNesse.

3. Please don't rush. You are never in a hurry with FitNesse. There are no deadlines. Keep this code as clean as you can. Maintain the highest pride in your workmanship. Don't make messes. See the "Clean Code" book for more.

4. Whenever you make a change, submit it as a pull request on https://github.com/unclebob/fitnesse. Pull requests will get a milestone "Next release" associated to them when they are merged. This milestone is used to compose the release notes.

5. If you have any questions, ask Uncle Bob.