svn commit: r1084363 - /incubator/libcloud/site/trunk/content/libcloud/contributing.mdtext

[to...@apache.org]

Author: tomaz
Date: Tue Mar 22 21:44:53 2011
New Revision: 1084363

URL: http://svn.apache.org/viewvc?rev=1084363&view=rev
Log:
Add "contributing" page

Added:
    incubator/libcloud/site/trunk/content/libcloud/contributing.mdtext   (with props)

Added: incubator/libcloud/site/trunk/content/libcloud/contributing.mdtext
URL: http://svn.apache.org/viewvc/incubator/libcloud/site/trunk/content/libcloud/contributing.mdtext?rev=1084363&view=auto
==============================================================================
--- incubator/libcloud/site/trunk/content/libcloud/contributing.mdtext (added)
+++ incubator/libcloud/site/trunk/content/libcloud/contributing.mdtext Tue Mar 22 21:44:53 2011
@@ -0,0 +1,46 @@
+Title:
+Notice:    Licensed to the Apache Software Foundation (ASF) under one
+           or more contributor license agreements.  See the NOTICE file
+           distributed with this work for additional information
+           regarding copyright ownership.  The ASF licenses this file
+           to you under the Apache License, Version 2.0 (the
+           "License"); you may not use this file except in compliance
+           with the License.  You may obtain a copy of the License at
+           .
+             http://www.apache.org/licenses/LICENSE-2.0
+           .
+           Unless required by applicable law or agreed to in writing,
+           software distributed under the License is distributed on an
+           "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+           KIND, either express or implied.  See the License for the
+           specific language governing permissions and limitations
+           under the License.
+
+## Contributing to libcloud ##
+
+This pages explains how you can contribute to the libcloud project.
+
+Keep in mind that all kind of contributions are welcome (ideas, code, tests, documentation, examples, ...).
+
+### Process ###
+
+ 1. Start a discussion on the [mailing list](devinfo.html) (this step is optional and only required if you want to implement big feature or a change)
+ 1. Open a new issue on the [bug tracker](https://issues.apache.org/jira/browse/LIBCLOUD) (Jira)
+ 2. Fork libcloud [github git repository](https://github.com/apache/libcloud)* and make your changes
+   1. Create a new branch for your changes (e.g. git checkout -b jira_issue_id_change_name)
+   2. Make your changes
+  3. Write tests for your modifications and make sure that all the tests still pass (python setup.py test)
+ 3. Create a patch with your changes
+  1. git (format-patch):  
+     ::bash  
+      git format-patch --stdout trunk > patch_name.patch
+  2. git (diff):  
+    ::bash  
+    git diff --no-prefix trunk your_branch > patch_name.patch
+  3. svn:  
+    ::bash  
+    svn diff > patch_name.patch
+ 4. Attach patch to the ticket you have created
+ 5. Wait for your patch to be reviewed and / or accepted
+
+*Note: If you want you can also use SVN repository, bit git and github make branching and contributing a bit easier.*
\ No newline at end of file

Propchange: incubator/libcloud/site/trunk/content/libcloud/contributing.mdtext
------------------------------------------------------------------------------
    svn:eol-style = native