apex-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From chinmaykolhatkar <...@git.apache.org>
Subject [GitHub] apex-site pull request #50: APEXCORE-534 Improve contributor setup instructi...
Date Thu, 15 Sep 2016 15:09:54 GMT
Github user chinmaykolhatkar commented on a diff in the pull request:

    --- Diff: src/md/contributing.md ---
    @@ -14,7 +14,38 @@ This project welcomes new contributors and invites everyone to participate.
     People that help with the project in any of the above categories or other ways are contributors.
See the [roles](http://www.apache.org/foundation/how-it-works.html#roles) as defined by the
ASF. Community members that make sustained, welcome contributions to the project may be invited
to become a [committer](/people.html). 
    -## Code Style
    +## Before coding: One time Setup
    +### JIRA
    +Apache JIRA is used for issue tracking. If you do not already have an Apache JIRA account,
sign up [here](https://issues.apache.org/jira/). Note that the user name should have no white
spaces or other special characters that complicate auto-completion within JIRA comments etc.

    +Please use a single JIRA account only (don't create multiple with different email addresses)
to retain the issue history. Please use a permanent email address, for an existing account
it can be changed in the profile. If you absolutely have to change your user name, contact
    +Apex has 2 JIRA projects:
    +1. [APEXCORE](https://issues.apache.org/jira/browse/APEXCORE/) for [apex-core](https://github.com/apache/apex-core)
and [apex-site](https://github.com/apache/apex-site)
    +2. [APEXMALHAR](https://issues.apache.org/jira/browse/APEXMALHAR/) for [apex-malhar](https://github.com/apache/apex-malhar)
    +Before working on changes for any of the repositories, please locate an existing JIRA
ticket or submit a new one. In order to assign an issue to yourself, you need to be listed
as contributor in the JIRA project. PMC members have access to add new contributors, please
request to be added through a comment on the candidate ticket.
    +### Github and git
    +We use GitHub’s pull request functionality to review proposed code changes. If you
do not already have a personal GitHub account, sign up [here](https://github.com/join). We
recommend that you use the same email address and first/lastname for emails, git and JIRA
so that contributions can be better tracked and notifications correlated. It is also recommended
that you use an email address that is valid permanently (for example the @apache.org address,
if you have one). Please also see:
    --- End diff --
    In sentence "for example ....." Only committers will apache email address. That's not
encouraging IMO... Rather give example as "@gmail.com"... gmail.com will most likely be personal
id and not company address.. That's added advantage. :)

If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.

View raw message