| layout | title |
|---|---|
documentation |
Contributing to openHAB |
{% include base.html %}
openHAB is a community effort and everyone can take part in that. Be it by being an active developer, a one time bug reporter or by commenting on issues by others. Please the following guidelines.
Before reporting an issue, please check the openHAB community forum for solutions and help. More people will see your issue when it is posted in the forum and community members may be able to help you find known solutions/workarounds.
When no solution was found, use the table below to determine where your issue should be reported:
| Issue | Where to report |
|---|---|
| Problems and feature requests for openHAB 1 add-ons | openHAB |
| Problems and feature requests for openHAB 2 add-ons | openHAB2 |
| Issues related to the runtime environment, IDE and packaging | openHAB-distro |
| Issues related to the core openHAB bundles that are not from Eclipse SmartHome | openHAB-core |
| Issues related to Eclipse SmartHome add-ons and core runtime | Eclipse SmartHome |
But do not worry - if you are not clear, which category your issue belongs to - we will redirect you, if necessary.
Please pay attention to the respective CONTRIBUTING.md file in all of these repositories.
They include further details on how to report an issue or file a pull request.
We want to keep the openHAB community awesome, growing and collaborative. We need your help to keep it that way. To help with this we've come up with some general guidelines for the community as a whole:
-
Be nice: Be courteous, respectful and polite to fellow community members: no regional, racial, gender, or other abuse will be tolerated. We like nice people way better than mean ones!
-
Encourage diversity and participation: Make everyone in our community feel welcome, regardless of their background and the extent of their contributions, and do everything possible to encourage participation in our community.
-
Keep it legal: Basically, don't get us in trouble. Share only content that you own, do not share private or sensitive information, and don't break the law.
-
Stay on topic: Make sure that you are posting to the correct channel and avoid off-topic discussions. Remember when you update an issue or respond to an email you are potentially sending to a large number of people. Please consider this before you update. Also remember that nobody likes spam.