# Contributing

We love contributions! We really need your help to [fabric8 more awesome](http://fabric8.io/), so please [join our community](#/site/doc/community.html)!

Many thanks to all of our [existing contributors](https://github.com/fabric8io/fabric8/graphs/contributors)! Why not dive in and help?

Here's some notes to help you get started:

## Getting Started

* Make sure you have a [GitHub account](https://github.com/signup/free) as you'll need it to submit issues, comments or pull requests.
* Got any ideas for how we can improve fabric8? Please [submit an issue](https://github.com/fabric8io/fabric8/issues?state=open) with your thoughts. Constructive criticism is always greatly appreciated!
* Fancy submitting a blog post, article or screencastwe can link to? Just [submit an issue](https://github.com/fabric8io/fabric8/issues?state=open) and we'll merge it into our website.
* Search [our issue tracker](https://github.com/fabric8io/fabric8/issues?state=open) and see if there's been any ideas or issues reported for what you had in mind; if so please join the conversation in the comments.
* Submit any issues, feature requests or improvement ideas [our issue tracker](https://github.com/fabric8io/fabric8/issues?state=open).
  * Clearly describe the issue including steps to reproduce when it is a bug.
  * Make sure you fill in the earliest version that you know has the issue.

### Fancy hacking some code?

* If you fancy working on some code, check out the these lists of issues:
   * [all open issues](https://github.com/fabric8io/fabric8/issues?state=open) if you fancy being more adventurous.

* To make code changes, fork the repository on GitHub then you can hack on the code. We love any contribution such as:
   * fixing typos
   * improving the documentation or embedded help
   * writing new test cases or improve existing ones
   * adding new features

## Submitting changes to fabric8

* Push your changes to your fork of the [fabric8 repository](https://github.com/fabric8io/fabric8).
* Submit a pull request to the repository in the **fabric8io** organization.
* If your change references an existing [issue](https://github.com/fabric8io/fabric8/issues?state=open) then use "fixes #123" in the commit message (using the correct issue number ;).

# Additional Resources

* [fabric8 FAQ](#/site/FAQ.md)
* [General GitHub documentation](http://help.github.com/)
* [GitHub create pull request documentation](hhttps://help.github.com/articles/creating-a-pull-request)
* [join the fabric8 community](#/site/doc/community.html)

