Github user chinmaykolhatkar commented on a diff in the pull request:
https://github.com/apache/apex-site/pull/50#discussion_r78984813
--- Diff: src/md/contributing.md ---
@@ -14,7 +14,38 @@ This project welcomes new contributors and invites
everyone to participate. Our
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 INFRA.
+
+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.
--- End diff --
Rather than adding a comment on tkt, should we ask new contributor to send
a mail to dev@apex for contributor access.
That way, the PMC/Committers can follow up with new contributor and help
the person if required. This way, he/she gets introduced to the community at
the same time, existing community members gets chance to give new contributers
next step.
---
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 [email protected] or file a JIRA ticket
with INFRA.
---
