github.com/nullne/docker@v1.13.0-rc1/project/ISSUE-TRIAGE.md (about) 1 Triaging of issues 2 ------------------ 3 4 Triage provides an important way to contribute to an open source project. Triage helps ensure issues resolve quickly by: 5 6 - Describing the issue's intent and purpose is conveyed precisely. This is necessary because it can be difficult for an issue to explain how an end user experiences a problem and what actions they took. 7 - Giving a contributor the information they need before they commit to resolving an issue. 8 - Lowering the issue count by preventing duplicate issues. 9 - Streamlining the development process by preventing duplicate discussions. 10 11 If you don't have time to code, consider helping with triage. The community will thank you for saving them time by spending some of yours. 12 13 ### 1. Ensure the issue contains basic information 14 15 Before triaging an issue very far, make sure that the issue's author provided the standard issue information. This will help you make an educated recommendation on how this to categorize the issue. Standard information that *must* be included in most issues are things such as: 16 17 - the output of `docker version` 18 - the output of `docker info` 19 - the output of `uname -a` 20 - a reproducible case if this is a bug, Dockerfiles FTW 21 - host distribution and version ( ubuntu 14.04, RHEL, fedora 23 ) 22 - page URL if this is a docs issue or the name of a man page 23 24 Depending on the issue, you might not feel all this information is needed. Use your best judgement. If you cannot triage an issue using what its author provided, explain kindly to the author that they must provide the above information to clarify the problem. 25 26 If the author provides the standard information but you are still unable to triage the issue, request additional information. Do this kindly and politely because you are asking for more of the author's time. 27 28 If the author does not respond requested information within the timespan of a week, close the issue with a kind note stating that the author can request for the issue to be 29 reopened when the necessary information is provided. 30 31 ### 2. Classify the Issue 32 33 An issue can have multiple of the following labels. Typically, a properly classified issues should 34 have: 35 36 - One label identifying its kind (`kind/*`). 37 - One or multiple labels identifying the functional areas of interest (`area/*`). 38 - Where applicable, one label categorizing its difficulty (`exp/*`). 39 40 #### Issue kind 41 42 | Kind | Description | 43 |------------------|---------------------------------------------------------------------------------------------------------------------------------| 44 | kind/bug | Bugs are bugs. The cause may or may not be known at triage time so debugging should be taken account into the time estimate. | 45 | kind/enhancement | Enhancement are not bugs or new features but can drastically improve usability or performance of a project component. | 46 | kind/feature | Functionality or other elements that the project does not currently support. Features are new and shiny. | 47 | kind/question | Contains a user or contributor question requiring a response. | 48 49 #### Functional area 50 51 | Area | 52 |---------------------------| 53 | area/api | 54 | area/builder | 55 | area/bundles | 56 | area/cli | 57 | area/daemon | 58 | area/distribution | 59 | area/docs | 60 | area/kernel | 61 | area/logging | 62 | area/networking | 63 | area/plugins | 64 | area/project | 65 | area/runtime | 66 | area/security | 67 | area/security/apparmor | 68 | area/security/seccomp | 69 | area/security/selinux | 70 | area/security/trust | 71 | area/storage | 72 | area/storage/aufs | 73 | area/storage/btrfs | 74 | area/storage/devicemapper | 75 | area/storage/overlay | 76 | area/storage/zfs | 77 | area/swarm | 78 | area/testing | 79 | area/volumes | 80 81 #### Platform 82 83 | Platform | 84 |---------------------------| 85 | platform/arm | 86 | platform/darwin | 87 | platform/ibm-power | 88 | platform/ibm-z | 89 | platform/windows | 90 91 #### Experience level 92 93 Experience level is a way for a contributor to find an issue based on their 94 skill set. Experience types are applied to the issue or pull request using 95 labels. 96 97 | Level | Experience level guideline | 98 |------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| 99 | exp/beginner | New to Docker, and possibly Golang, and is looking to help while learning the basics. | 100 | exp/intermediate | Comfortable with golang and understands the core concepts of Docker and looking to dive deeper into the project. | 101 | exp/expert | Proficient with Docker and Golang and has been following, and active in, the community to understand the rationale behind design decisions and where the project is headed. | 102 103 As the table states, these labels are meant as guidelines. You might have 104 written a whole plugin for Docker in a personal project and never contributed to 105 Docker. With that kind of experience, you could take on an <strong 106 class="gh-label expert">exp/expert</strong> level task. 107 108 #### Triage status 109 110 To communicate the triage status with other collaborators, you can apply status 111 labels to issues. These labels prevent duplicating effort. 112 113 | Status | Description | 114 |-------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| 115 | status/confirmed | You triaged the issue, and were able to reproduce the issue. Always leave a comment how you reproduced, so that the person working on resolving the issue has a way to set up a test-case. 116 | status/accepted | Apply to enhancements / feature requests that we think are good to have. Adding this label helps contributors find things to work on. 117 | status/more-info-needed | Apply this to issues that are missing information (e.g. no `docker version` or `docker info` output, or no steps to reproduce), or require feedback from the reporter. If the issue is not updated after a week, it can generally be closed. 118 | status/needs-attention | Apply this label if an issue (or PR) needs more eyes. 119 120 ### 3. Prioritizing issue 121 122 When, and only when, an issue is attached to a specific milestone, the issue can be labeled with the 123 following labels to indicate their degree of priority (from more urgent to less urgent). 124 125 | Priority | Description | 126 |-------------|-----------------------------------------------------------------------------------------------------------------------------------| 127 | priority/P0 | Urgent: Security, critical bugs, blocking issues. P0 basically means drop everything you are doing until this issue is addressed. | 128 | priority/P1 | Important: P1 issues are a top priority and a must-have for the next release. | 129 | priority/P2 | Normal priority: default priority applied. | 130 | priority/P3 | Best effort: those are nice to have / minor issues. | 131 132 And that's it. That should be all the information required for a new or existing contributor to come in an resolve an issue.