Project

General

Profile

Contribute » History » Version 1

Ohad Levy, 12/05/2009 01:50 PM

1 1 Ohad Levy
h1. Contribute
2 1 Ohad Levy
3 1 Ohad Levy
{{>toc}}
4 1 Ohad Levy
5 1 Ohad Levy
Foreman is built and maintained by community volunteers. If you enjoy using it and would like give back to the community, there are several ways to contribute back to the project.
6 1 Ohad Levy
7 1 Ohad Levy
h2. Code Related
8 1 Ohad Levy
9 1 Ohad Levy
These require a familiarity with Ruby on Rails development. If you are still new to Rails, Community members can help you if you get stuck with something or have any other questions.
10 1 Ohad Levy
11 1 Ohad Levy
You will need to download a copy of the current development-code. The official code repository is located in Github and can be downloaded by following the [[Installation_instructions#Latest-source-code]].
12 1 Ohad Levy
13 1 Ohad Levy
Please note that there are two important branches:
14 1 Ohad Levy
15 1 Ohad Levy
*Master* - latest stable code
16 1 Ohad Levy
*Edge*   - new features
17 1 Ohad Levy
18 1 Ohad Levy
Bugfixes will be usually committed to both branches.
19 1 Ohad Levy
20 1 Ohad Levy
21 1 Ohad Levy
h3. Development
22 1 Ohad Levy
23 1 Ohad Levy
Patches to fix bugs or add new features are always appreciated. If you are going to work on a specific issue, make a note in the issue details so the developers will know what you're working on.
24 1 Ohad Levy
25 1 Ohad Levy
We try to keep a one commit per bug/feature policy, please try to create an issue which is specific for your patch details.
26 1 Ohad Levy
27 1 Ohad Levy
h2. Non Code Related
28 1 Ohad Levy
29 1 Ohad Levy
These don't require any software development experience, just some time and the desire to help.
30 1 Ohad Levy
31 1 Ohad Levy
h3. User support
32 1 Ohad Levy
33 1 Ohad Levy
Helping out other users in the "Forums" is always useful. Frequent problems or questions should be brought up so the wiki can be updated to help future users.
34 1 Ohad Levy
35 1 Ohad Levy
Testing is also very welcomed, for any issue encountered, please open a bug / feature request.
36 1 Ohad Levy
37 1 Ohad Levy
h3. Issue triage
38 1 Ohad Levy
39 1 Ohad Levy
Sometimes issues are reported without all the information needed by a developer. Getting the details of the bug or feature from the reporter and the community will help everyone understand what is needed.
40 1 Ohad Levy
41 1 Ohad Levy
h3. Design and User interface
42 1 Ohad Levy
43 1 Ohad Levy
Foreman uses a very basic design and user interface. Any improvements to it including new themes, skinning, or interface adjustments could help every user.