Gabriel Reid created PHOENIX-963:
------------------------------------

             Summary: Add a description of how to contribute
                 Key: PHOENIX-963
                 URL: https://issues.apache.org/jira/browse/PHOENIX-963
             Project: Phoenix
          Issue Type: Improvement
            Reporter: Gabriel Reid


There is currently no clear description of how to create and submit patches to 
Phoenix, with a number of options for creating and submitting patches (e.g. 
GitHub PR, Jira with git diff, Jira with git am). Also, while many users are 
familiar with working with GitHub pull requests, there are many who are less 
familiar with manually generating patches with git.

A page should be added to the Phoenix website describing the (recommended) 
workflow to be followed when developing and submitting a patch to Phoenix. This 
should include an explanation of at least the following:
* how to check out the code
* recommendations on unit tests (e.g. where to locate unit and integration 
tests)
* code style requirements
* how to create and upload a patch

Although these are things that are basic knowledge for many (and are repeated 
on many ASF project websites), it can be useful for newcomers who either don't 
know some of these details, or want to make sure they're doing things in line 
with expectations.



--
This message was sent by Atlassian JIRA
(v6.2#6252)

Reply via email to