OpenRemote Community
First and foremost, OpenRemote is a open community. Here you will find software professionals, installation professionals, as well as hobbyists. After all, the point of an Open Source approach is to lower the barriers to entry for everyone. You need not strictly be a developer to contribute to OpenRemote. Sometimes just feedback on our features and software helps us tremendously.
In many cases, hearing from you and the hardware you use is interesting enough. Often times, developers will contribute the integration to the hardware they use. And that is good enough. If you want to contribute to OpenRemote, please contact us on the forums.
OpenRemote Users
The following documents are recommended reading for developers who want to get started with OpenRemote.
Source Code Repository.
OpenRemote source code repository is hosted by Sourceforge. The repository can be read by everyone and various components and projects can be built from the checked out source. See more detailed instructions on building sub-projects below.
For those looking to add their contributions to the source base, first you must sign an OpenRemote Contributor License Agreement (ORCLA). Please let us know by email if you're interested in contributing your code to the project.
The source repository is currently using Subversion. It is of utmost importance that you're familiar with using Subversion if you want write access to repository. In particular, we heavily use branches and merges to manage and review the codebase changes, so you must be familiar and comfortable with using these features of Subversion. A good, free book on Subversion is available with examples.
If you plan to actively contribute code to OpenRemote, you should (really, you should) subscribe to the SVN log mailing list to keep abreast with the work other developers are committing. This helps with coordinating the project. It is a high traffic list so be prepared to filter and route messages with your email client accordingly.
Build Instructions
For those looking to build latest development work but not necessarily contribute code back (yet, we hope you'll get to sending patches and fixes to bugs you find soon), the following documents are of interest:
Source Code Conventions
We do maintain source code conventions. While a lot of the existing code does not yet comply with these, if you plan on adding new code to the codebase, please do observe the code conventions and adhere to them.
As for patching existing code, just follow the existing code conventions as closely as possible (even if they don't match to the code conventions below).
