jorisvandenbossche commented on code in PR #14889: URL: https://github.com/apache/arrow/pull/14889#discussion_r1047098543
########## docs/source/developers/guide/documentation.rst: ########## @@ -37,26 +37,15 @@ incomplete or inaccurate, share your hard-earned knowledge with the rest of the community. If you didn't come across something to improve in the -documentation itself, you can search for an issue on JIRA. +documentation itself, you can search for an issue in GitHub. .. note:: - When searching for JIRA issue that deals with documentation, - try selecting **Components** from the **More** tab in JIRA search - and select **Documentation** from the list. + When searching for an issue that deals with documentation, + navigate to `GitHub labels <https://github.com/apache/arrow/labels>`_ + and select **Component:Documentation** or search for **Documentation** Review Comment: ```suggestion and select **Component: Documentation** or search for **Documentation** ``` ########## docs/source/developers/guide/step_by_step/finding_issues.rst: ########## @@ -38,103 +38,50 @@ 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 that we use. +For both cases, GitHub is the issue tracker that we use. -First we will explain how to use JIRA if you have a fix or a feature -to work on that doesn't yet have a JIRA ticket open, in which case you -will need to create a JIRA ticket yourself. +- If you do not have a GitHub account yet, navigate to the + `GitHub login page <https://github.com/join>`_ to create one. +- If you need help with creating a new GitHub issue see + `GitHub documentation <https://docs.github.com/en/issues/tracking-your-work-with-issues/creating-an-issue>`_. -Secondly, we will show you a way to find good first issues to work on. +When the ticket is created you can start a discussion about it in theGitHub comments. Review Comment: ```suggestion When the ticket is created you can start a discussion about it in the GitHub comments. ``` ########## docs/source/developers/guide/step_by_step/finding_issues.rst: ########## @@ -38,103 +38,50 @@ 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 that we use. +For both cases, GitHub is the issue tracker that we use. -First we will explain how to use JIRA if you have a fix or a feature -to work on that doesn't yet have a JIRA ticket open, in which case you -will need to create a JIRA ticket yourself. +- If you do not have a GitHub account yet, navigate to the + `GitHub login page <https://github.com/join>`_ to create one. +- If you need help with creating a new GitHub issue see Review Comment: ```suggestion - If you need help with creating a new GitHub issue see the ``` ########## docs/source/developers/guide/step_by_step/finding_issues.rst: ########## @@ -38,103 +38,50 @@ 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 that we use. +For both cases, GitHub is the issue tracker that we use. -First we will explain how to use JIRA if you have a fix or a feature -to work on that doesn't yet have a JIRA ticket open, in which case you -will need to create a JIRA ticket yourself. +- If you do not have a GitHub account yet, navigate to the + `GitHub login page <https://github.com/join>`_ to create one. +- If you need help with creating a new GitHub issue see + `GitHub documentation <https://docs.github.com/en/issues/tracking-your-work-with-issues/creating-an-issue>`_. -Secondly, we will show you a way to find good first issues to work on. +When the ticket is created you can start a discussion about it in theGitHub comments. - -Creating a JIRA account -========================== - -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 be asked to select a language and choose an avatar if you wish. If -the registration is successful you will see: - -.. figure:: /developers/images/jira_new_account.jpeg - :scale: 70 % - :alt: creating an ASF JIRA account - - The window you get after creating an account on the ASF JIRA. - - -.. _create_jira: - -How to create a JIRA issue -========================== - -After creating an account you can click **Create an issue** and select -**Apache Arrow project** and **Type** of the issue (Bug, Feature, …). - -.. figure:: /developers/images/jira_create_issue.jpeg - :scale: 70 % - :alt: creating JIRA issue - - The window to create a JIRA issue. - -If you are already in JIRA dashboard click the red ``create`` button in -the top to do the same. - -You are ready to create the issue! Add a title and a description following -the guidance in :ref:`creating issues <creating-issues>` and you are ready to go! - -.. seealso:: - :ref:`Creating issues <creating-issues>` - -You don’t need any special permissions on JIRA to be able to create -or self-assign issues. -To get this role, ask on the :ref:`dev mailing list <mailing_list>`. - -When the ticket is created you can start a discussion about it in the -JIRA comments section. - -How we use JIRA to find an issue -================================ +GitHub labels +============= To make it easier for you to find issues that are well-suited for new -contributors, we have added labels like “good-first-issue” or “beginner” -to some JIRA tickets. +contributors, we have added a label **“good-first-issue”** to some +GitHub issues. .. seealso:: - Search for good first/second issues with labels like in the `link here - <https://issues.apache.org/jira/issues/?filter=-4&jql=project%20%3D%20ARROW%20AND%20status%20%3D%20Open%20AND%20labels%20in%20(Beginner%2C%20beginner%2C%20beginners%2C%20beginnner%2C%20beginner-friendly%2C%20good-first-issue%2C%20good-second-issue%2C%20GoodForNewContributors%2C%20newbie%2C%20easyfix%2C%20documentation)%20order%20by%20created%20DESC>`_ + Search for good first issues with labels like in the `link here Review Comment: ```suggestion Search for good first issues `good-first-issue label listing ``` -- 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: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
