rok commented on a change in pull request #11807: URL: https://github.com/apache/arrow/pull/11807#discussion_r761375764
########## File path: docs/source/developers/guide/step_by_step/finding_issues.rst ########## @@ -29,4 +29,82 @@ **************************** Finding good first issues 🔎 -**************************** \ No newline at end of file +**************************** + +You have successfully built Arrow library, congrats! + +The next step is finding something to work on. As was mentioned before, +you might already have a bug to fix in mind, or a new feature that you want to implement. +Or you still need an issue to work on and you need some help with finding one. + +For both cases JIRA is the issue tracker we use. + +First we will explain how to use JIRA if you have a fix or a feature to work on but +there is no issue about it created. In that case you need to create an issue yourself. + +Secondly we will show a way to find good first issues. + +How to create a JIRA issue +========================== + +First thing you need to do is to make an account on the ASF JIRA following +`this link <https://issues.apache.org/jira/secure/Signup!default.jspa>`_. You will have to +select your language and choose an avatar. If the registration is successful you will see: + +.. figure:: jira_1.jpeg + :scale: 70 % + :alt: creating an ASF JIRA account + + The window you get after creating an account on the ASF JIRA. + +Here you can click **Create an issue** and select **Apache Arrow project** and **Type** of +the issue (Bug, Feature, …). + +.. figure:: jira_2.jpeg + :scale: 70 % + :alt: creating JIRA issue + + The window to create a JIRA issue. + +You are ready to create the issue! Add a title and a description following the :ref:`tips for using JIRA <jira-tips> and you are ready to go! + +.. seealso:: + :ref:`Tips for using JIRA <jira-tips>` + +You don’t need any special permissions on JIRA to be able to create issues. +Once you are more involved in the project and want to do more on JIRA, for example assigning +yourself an issue, you will need “Contributor” permissions. To get this role, ask on the +mailing list or in the comment of the JIRA issue you created. Review comment: Maybe add a link to where they can join the mailing list? https://arrow.apache.org/community/ -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: github-unsubscr...@arrow.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org
