wiki:Guides/Contributing

Version 1 (modified by micke prag <micke.prag@…>, 7 years ago) (diff)

--

How to contribute code

Since most of Telldus code is released as Open Source it is not only possible for everyone to read the code, but everone can contribute with updates, and we encourage you to do so.

To ease up the development we are using git for the code and mirror it on two of the bigger git hosting sites; Gitorious and GitHub.

Why having the code in three places?
We belive it should be easy to help out. Some prefer one platform over the other. By offering the code on multiple places you can contribute from the platform you prefer.

New to Git?
There is some great guides available on the internet. One we like is  http://progit.org/book/

Telldus repository

Our main repository is hosted for anonymous access here:  http://git.telldus.com/telldus.git

For small updates this repository is probably the easiest way to get started. Check out the code using the following command:

$ git clone http://git.telldus.com/telldus.git

Change some files and commit them back to your clone:

$ git add a-changed-file
$ git commit -m "Changed the file a-changed-file"

For sending patches to us you can create patch-files using the format-patch command.

$ git format-patch origin/master

This command creates one or many numbered *.patch files, one for each commit. In this case only one file named 0001-Changed-the-file-a-changed-file.patch

Create a ticket, describing the change, and attach the patchfiles you have for the bug/feature.

Gitorious/GitHub

The workflow for both Gitorious and GitHub is quite similar. This is suitable if you plan on contributing more than once or twice.

You need to have a user account on one of the sites first. You can then fork our repository, creating your own, before cloning the repository.

Our Gitorious repository is available here  https://www.gitorious.org/telldus/telldus and for GitHub here:  https://github.com/telldus/telldus

When you have changed some files and commited them you can push them back to Gitorious/GitHub. When you are ready to contribute back to Telldus, use the "Pull request feature" and we will be alerted of your changes.