Changes between Initial Version and Version 1 of Guides/Contributing

Timestamp:

Mar 14, 2012, 2:31:18 PM (13 years ago)

Author:

Micke Prag

Comment:

--

Guides/Contributing

@@ +1 @@
+== 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?[[BR]]
+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?[[BR]]
+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:[[BR]]
+{{{
+$ git clone http://git.telldus.com/telldus.git
+}}}
+
+Change some files and commit them back to your clone:[[BR]]
+{{{
+$ 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.