You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@airavata.apache.org by sm...@apache.org on 2014/07/10 20:19:56 UTC

svn commit: r1609545 - /airavata/site/trunk/content/community/how-to-contribute-code.mdtext

Author: smarru
Date: Thu Jul 10 18:19:55 2014
New Revision: 1609545

URL: http://svn.apache.org/r1609545
Log:
adding bullets

Modified:
    airavata/site/trunk/content/community/how-to-contribute-code.mdtext

Modified: airavata/site/trunk/content/community/how-to-contribute-code.mdtext
URL: http://svn.apache.org/viewvc/airavata/site/trunk/content/community/how-to-contribute-code.mdtext?rev=1609545&r1=1609544&r2=1609545&view=diff
==============================================================================
--- airavata/site/trunk/content/community/how-to-contribute-code.mdtext (original)
+++ airavata/site/trunk/content/community/how-to-contribute-code.mdtext Thu Jul 10 18:19:55 2014
@@ -16,39 +16,40 @@ Notice:    Licensed to the Apache Softwa
            specific language governing permissions and limitations
            under the License.
 
+### Apache Airavata Contribution Guide 
 Welcome and thank you for your interest in contributing to Apache Airavata! This guide will take you through the process of making contributions to the airavata code base.
 
-0. Engage with the community
+#### Engage with the community
 
-Identify an issue or documentation that you want to fix or improve. Search [JIRA] [jira] and the mailing list to see if it’s already been discussed.
+Identify an issue or documentation that you want to fix or improve. Search [JIRA] [jira] and the mailing list to see if it’s already been discussed.    
 
-1. Create an issue in JIRA
+#### Create an issue in JIRA
 
-If it’s a bug or a feature request, open a JIRA issue. Create a sample that you can use for prototyping the feature or demonstrating the bug. If creating a sample is time consuming, write steps to reproduce the issue. Attach this sample to the JIRA issue if it’s representing a bug report.
+If it’s a bug or a feature request, open a JIRA issue. Create a sample that you can use for prototyping the feature or demonstrating the bug. If creating a sample is time consuming, write steps to reproduce the issue. Attach this sample to the JIRA issue if it’s representing a bug report.   
 
-2. Create a pull request in GitHub
+#### Create a pull request in GitHub
 
 [Checkout] [checkout] the source code. Create a pull request (PR) in GitHub for the change you're interested in making. The comment section of the PR must contain a link to the JIRA issue. Please also reference the issue in the commit message, and make sure it properly describes the changes that have been made and their purpose.
 
-Some good references for working with GitHub are below. We ask that you keep your change rebased to master as much as possible, and we will ask you to rebase again if master has moved before accepting your patch.
+Some good references for working with GitHub are below. We ask that you keep your change rebased to master as much as possible, and we will ask you to rebase again if master has moved before accepting your patch.   
 
 * [Setting Up Git with GitHub][setup-git]
 * [Forking a Repository][fork-repo]
 * [Submitting Pull Requests][pull-request]
-* [Rebasing your Branch][rebase-branch]
+* [Rebasing your Branch][rebase-branch]    
 
-3. Comment the issue in JIRA
+#### Comment the issue in JIRA
 
-Finally, add a comment in the JIRA issue with a link to the pull request so we know the code is ready to be reviewed.
+Finally, add a comment in the JIRA issue with a link to the pull request so we know the code is ready to be reviewed.   
 
 
-4. The review process
+#### The review process
 
-The airavata community will need to review your pull request before it is merged. If we are slow to respond, feel free to also email the dev mailing list: dev@airavata.apache.org. 
+The airavata community will need to review your pull request before it is merged. If we are slow to respond, feel free to also email the dev mailing list: dev@airavata.apache.org.    
 
 During the review process you may be asked to make some changes to your submission. While working through feedback, it can be beneficial to create new commits so the incremental change is obvious. This can also lead to a complex set of commits, and having an atomic change per commit is preferred in the end. Use your best judgement and work with your reviewer as to when you should revise a commit or create a new one.
 
-A pull request is considered ready to be merged once it gets at lease one +1 from a reviewer. Once all the changes have been completed and the pull request is accepted, it must be rebased to the latest upstream version. It is also a good idea to squash all the commits into a single one, since this will allow us to generate a clean patch and merge it properly.
+A pull request is considered ready to be merged once it gets at lease one +1 from a reviewer. Once all the changes have been completed and the pull request is accepted, it must be rebased to the latest upstream version. It is also a good idea to squash all the commits into a single one, since this will allow us to generate a clean patch and merge it properly.   
 
 [jira]: https://issues.apache.org/jira/browse/airavata
 [checkout]: source.html