AlenkaF commented on code in PR #14919: URL: https://github.com/apache/arrow/pull/14919#discussion_r1046831412
########## docs/source/developers/bug_reports.rst: ########## @@ -203,59 +190,24 @@ Identify affected version +++++++++++++++++++++++++ If you're reporting something that used to work in a previous version -but doesn't work in the current release, you can add the **Affects version** -field to identify the earliest known version where the bug is observed. -For feature requests and other proposals, leave **Affects version** empty as -it is not applicable. +but doesn't work in the current release, you add the **Affects version** +in the description to identify the earliest known version where the bug is +observed. .. _issue-lifecycle: Issue lifecycle =============== -Both bug reports and feature requests follow a defined lifecycle. The issue -**Status** field is used to document the current state of the issue, while the -**Resolution** field indicates the outcome of issues that have reached -terminal status. - - -.. _issue-status: - -Issue Status -++++++++++++ - -The Arrow project uses the following statuses in Jira to indicate what has - -and will be - done on an issue: - -* **Open** - This is the initial issue state, prior to a contributor assigning - the issue and starting progress. Issues in this state should be unassigned. -* **In progress** - At the time a contributor self-assigns an issue, the status - should be set to In progress by clicking the **Start progress** button. All - issues in this status should have an assignee - unassigned issues will be - set back to a status of Open. Issues remain "in progress" until resolved or - closed, including during review of pull requests. -* **Resolved** - This is a terminal status indicating action has been taken - on the issue, which is now considered completed. Issues in a resolved status - should have a resolution code set to **Fixed**. -* **Closed** - Another terminal status, Closed indicates the issue is complete, - but *without* action being taken. The following resolution codes apply to - issues in Closed status: - - * Won't Fix - * Duplicate - * Invalid - * Incomplete - * Cannot Reproduce - * Not a Problem - * Not a Bug - * Workaround - * Information Provided - * Works for Me - * Won't Do - * Abandoned - -* **Reopened** - When an issue has been closed or resolved, but additional - attention is needed, it may be reopened. +Both bug reports and feature requests follow a defined lifecycle. If the issue +is currently worked on it has a developer assigned. When the issue has reached +a terminal status, it is labeled as closed. + +* **Closed as completed** - indicates the issue is complete and the PR that + resolved the issue should be added in a following comment. + +* **closed as not planned** - indicates the issue is complete, + but *without* action being taken. Review Comment: Oh yeah, of course. What I meant was that the link should be done automatically and it should be visible as a comment in the GitHub issue for the user to see. I will change the text with what you have suggested as it is much clearer, thanks! -- 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]
