{"action":"created","comment":{"url":"https://api.github.com/repos/saltstack/salt/pulls/comments/29705200","id":29705200,"diff_hunk":"@@ -0,0 +1,279 @@\n+.. _labels-and-milestones:\n+\n+============================\n+GitHub Labels and Milestones\n+============================\n+\n+SaltStack uses several labeling schemes, as well as applying milestones, to triage incoming issues and pull requests in\n+the GitHub Issue Tracker. Most of the labels and milestones are used for internal tracking, but the following\n+definitions might prove useful for the community to discover the best issues to help resolve.\n+\n+Milestones\n+==========\n+\n+Milestones are most often applied to issues, as a milestone is assigned to every issue that has been triaged. However,\n+milestones can also be applied to pull requests. SaltStack uses milestones to track bugs or features that should be\n+included in the next major feature release, or even the next bug-fix release, as well as what issues are ready to be\n+worked on or what might be blocked. All incoming issues must have a milestone associated with them.\n+\n+Approved\n+    Used to indicate that this issue has all of the needed information and is ready to be worked on.\n+\n+Blocked\n+    Used to indicate that the issue is not ready to be worked on yet. This typically applies to issues that have been\n+    labeled with “Info Needed”, “Question”, “Expected Behavior”, “Won’t Fix for Now”, etc.\n+\n+Dot or Bug-fix Release\n+    Used to help filter/identify what issues must be fixed before the release such as 2014.7.4 or 2015.2.3. This\n+    milestone is often used in conjunction with the ``Blocker`` label, but not always.\n+\n+Feature Release\n+    Similar to the Dot or Bug-fix Release milestone, but for upcoming feature releases such as Boron, Carbon, etc.\n+    This milestone is often used in conjunction with the ``Blocker`` label, but not always.\n+\n+Labels\n+======\n+\n+Labels are used to facilitate the resolution of new pull requests and open issues. Most labels are confined to being\n+applied to either issues or pull requests, though some labels may be applied to both.\n+\n+Issue Labels\n+------------\n+\n+All incoming issues should be triaged with at least one label and a milestone. When a new issue comes in, it should be\n+determined if the issue is a bug or a feature request, and either of those labels should be applied accordingly. Bugs\n+and Feature Requests have differing labeling schemes, detailed below, where other labels are applied to them to further\n+help contributors find issues to fix or implement.\n+\n+There are some labels, such as ``Question`` or some of the \"Status\" labels that may be applied as \"stand alone\" labels\n+in which more information may be needed or a decision must be reached on how to proceed. (See the \"Bug Status Labels\"\n+section below.)\n+\n+Features\n+~~~~~~~~\n+\n+The ``Feature`` label should be applied when a user is requesting entirely new functionality. This can include new\n+functions, modules, states, modular systems, flags for existing functions, etc. Features *do not* receive severity\n+or priority labels, as those labels are only used for bugs. However, they may receive \"Functional Area\" labels or \"ZD\".\n+\n+Feature request issues will be prioritized on an \"as-needed\" basis using milestones during SaltStack's feature release\n+and sprint planning processes.\n+\n+Bugs\n+~~~~\n+\n+All bugs should have the ``Bug`` label as well as a severity, priority, functional area, and a status, as applicable.\n+\n+Severity\n+^^^^^^^^\n+\n+How severe is the bug? SaltStack uses four labels to determine the severity of a bug: ``Blocker``, ``Critical``,\n+``High``, and ``Medium``. This scale is intended to make the bug-triage process as objective as possible.\n+\n+Blocker\n+    Should be used sparingly to indicate must-have fixes for the impending release.\n+\n+Critical\n+    Applied to bugs that have data loss, crashes, hanging, unresponsive system, or have no workaround.","path":"doc/topics/development/labels.rst","position":77,"original_position":77,"commit_id":"ed788a2965bd1e4c446d42c4bf11277a6fae4492","original_commit_id":"ed788a2965bd1e4c446d42c4bf11277a6fae4492","user":{"login":"basepi","id":702318,"avatar_url":"https://avatars.githubusercontent.com/u/702318?v=3","gravatar_id":"","url":"https://api.github.com/users/basepi","html_url":"https://github.com/basepi","followers_url":"https://api.github.com/users/basepi/followers","following_url":"https://api.github.com/users/basepi/following{/other_user}","gists_url":"https://api.github.com/users/basepi/gists{/gist_id}","starred_url":"https://api.github.com/users/basepi/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/basepi/subscriptions","organizations_url":"https://api.github.com/users/basepi/orgs","repos_url":"https://api.github.com/users/basepi/repos","events_url":"https://api.github.com/users/basepi/events{/privacy}","received_events_url":"https://api.github.com/users/basepi/received_events","type":"User","site_admin":false},"body":"I wouldn't mention workarounds here. We don't want to make any issue without a workaround Critical. *shrugs*","created_at":"2015-05-05T19:44:53Z","updated_at":"2015-05-05T19:44:53Z","html_url":"https://github.com/saltstack/salt/pull/23387#discussion_r29705200","pull_request_url":"https://api.github.com/repos/saltstack/salt/pulls/23387","_links":{"self":{"href":"https://api.github.com/repos/saltstack/salt/pulls/comments/29705200"},"html":{"href":"https://github.com/saltstack/salt/pull/23387#discussion_r29705200"},"pull_request":{"href":"https://api.github.com/repos/saltstack/salt/pulls/23387"}}},"pull_request":{"url":"https://api.github.com/repos/saltstack/salt/pulls/23387","id":34759432,"html_url":"https://github.com/saltstack/salt/pull/23387","diff_url":"https://github.com/saltstack/salt/pull/23387.diff","patch_url":"https://github.com/saltstack/salt/pull/23387.patch","issue_url":"https://api.github.com/repos/saltstack/salt/issues/23387","number":23387,"state":"open","locked":false,"title":"Add some \"What are all these labels for?\" documentation","user":{"login":"rallytime","id":6547906,"avatar_url":"https://avatars.githubusercontent.com/u/6547906?v=3","gravatar_id":"","url":"https://api.github.com/users/rallytime","html_url":"https://github.com/rallytime","followers_url":"https://api.github.com/users/rallytime/followers","following_url":"https://api.github.com/users/rallytime/following{/other_user}","gists_url":"https://api.github.com/users/rallytime/gists{/gist_id}","starred_url":"https://api.github.com/users/rallytime/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rallytime/subscriptions","organizations_url":"https://api.github.com/users/rallytime/orgs","repos_url":"https://api.github.com/users/rallytime/repos","events_url":"https://api.github.com/users/rallytime/events{/privacy}","received_events_url":"https://api.github.com/users/rallytime/received_events","type":"User","site_admin":false},"body":"Refs #23101","created_at":"2015-05-05T19:41:24Z","updated_at":"2015-05-05T19:44:53Z","closed_at":null,"merged_at":null,"merge_commit_sha":"293556a3bc6f3a63e32505914e52a4e3f157c444","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/saltstack/salt/pulls/23387/commits","review_comments_url":"https://api.github.com/repos/saltstack/salt/pulls/23387/comments","review_comment_url":"https://api.github.com/repos/saltstack/salt/pulls/comments{/number}","comments_url":"https://api.github.com/repos/saltstack/salt/issues/23387/comments","statuses_url":"https://api.github.com/repos/saltstack/salt/statuses/ed788a2965bd1e4c446d42c4bf11277a6fae4492","head":{"label":"rallytime:labels_docs","ref":"labels_docs","sha":"ed788a2965bd1e4c446d42c4bf11277a6fae4492","user":{"login":"rallytime","id":6547906,"avatar_url":"https://avatars.githubusercontent.com/u/6547906?v=3","gravatar_id":"","url":"https://api.github.com/users/rallytime","html_url":"https://github.com/rallytime","followers_url":"https://api.github.com/users/rallytime/followers","following_url":"https://api.github.com/users/rallytime/following{/other_user}","gists_url":"https://api.github.com/users/rallytime/gists{/gist_id}","starred_url":"https://api.github.com/users/rallytime/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rallytime/subscriptions","organizations_url":"https://api.github.com/users/rallytime/orgs","repos_url":"https://api.github.com/users/rallytime/repos","events_url":"https://api.github.com/users/rallytime/events{/privacy}","received_events_url":"https://api.github.com/users/rallytime/received_events","type":"User","site_admin":false},"repo":{"id":16396182,"name":"salt","full_name":"rallytime/salt","owner":{"login":"rallytime","id":6547906,"avatar_url":"https://avatars.githubusercontent.com/u/6547906?v=3","gravatar_id":"","url":"https://api.github.com/users/rallytime","html_url":"https://github.com/rallytime","followers_url":"https://api.github.com/users/rallytime/followers","following_url":"https://api.github.com/users/rallytime/following{/other_user}","gists_url":"https://api.github.com/users/rallytime/gists{/gist_id}","starred_url":"https://api.github.com/users/rallytime/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rallytime/subscriptions","organizations_url":"https://api.github.com/users/rallytime/orgs","repos_url":"https://api.github.com/users/rallytime/repos","events_url":"https://api.github.com/users/rallytime/events{/privacy}","received_events_url":"https://api.github.com/users/rallytime/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/rallytime/salt","description":"Central system and configuration manager ","fork":true,"url":"https://api.github.com/repos/rallytime/salt","forks_url":"https://api.github.com/repos/rallytime/salt/forks","keys_url":"https://api.github.com/repos/rallytime/salt/keys{/key_id}","collaborators_url":"https://api.github.com/repos/rallytime/salt/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/rallytime/salt/teams","hooks_url":"https://api.github.com/repos/rallytime/salt/hooks","issue_events_url":"https://api.github.com/repos/rallytime/salt/issues/events{/number}","events_url":"https://api.github.com/repos/rallytime/salt/events","assignees_url":"https://api.github.com/repos/rallytime/salt/assignees{/user}","branches_url":"https://api.github.com/repos/rallytime/salt/branches{/branch}","tags_url":"https://api.github.com/repos/rallytime/salt/tags","blobs_url":"https://api.github.com/repos/rallytime/salt/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/rallytime/salt/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/rallytime/salt/git/refs{/sha}","trees_url":"https://api.github.com/repos/rallytime/salt/git/trees{/sha}","statuses_url":"https://api.github.com/repos/rallytime/salt/statuses/{sha}","languages_url":"https://api.github.com/repos/rallytime/salt/languages","stargazers_url":"https://api.github.com/repos/rallytime/salt/stargazers","contributors_url":"https://api.github.com/repos/rallytime/salt/contributors","subscribers_url":"https://api.github.com/repos/rallytime/salt/subscribers","subscription_url":"https://api.github.com/repos/rallytime/salt/subscription","commits_url":"https://api.github.com/repos/rallytime/salt/commits{/sha}","git_commits_url":"https://api.github.com/repos/rallytime/salt/git/commits{/sha}","comments_url":"https://api.github.com/repos/rallytime/salt/comments{/number}","issue_comment_url":"https://api.github.com/repos/rallytime/salt/issues/comments{/number}","contents_url":"https://api.github.com/repos/rallytime/salt/contents/{+path}","compare_url":"https://api.github.com/repos/rallytime/salt/compare/{base}...{head}","merges_url":"https://api.github.com/repos/rallytime/salt/merges","archive_url":"https://api.github.com/repos/rallytime/salt/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/rallytime/salt/downloads","issues_url":"https://api.github.com/repos/rallytime/salt/issues{/number}","pulls_url":"https://api.github.com/repos/rallytime/salt/pulls{/number}","milestones_url":"https://api.github.com/repos/rallytime/salt/milestones{/number}","notifications_url":"https://api.github.com/repos/rallytime/salt/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/rallytime/salt/labels{/name}","releases_url":"https://api.github.com/repos/rallytime/salt/releases{/id}","created_at":"2014-01-31T00:54:22Z","updated_at":"2015-05-05T15:21:56Z","pushed_at":"2015-05-05T19:38:02Z","git_url":"git://github.com/rallytime/salt.git","ssh_url":"git@github.com:rallytime/salt.git","clone_url":"https://github.com/rallytime/salt.git","svn_url":"https://github.com/rallytime/salt","homepage":"saltstack.org","size":106637,"stargazers_count":0,"watchers_count":0,"language":"Python","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"develop"}},"base":{"label":"saltstack:develop","ref":"develop","sha":"7bb7f31ac492679300c8a7185f05b791c1cd5f22","user":{"login":"saltstack","id":1147473,"avatar_url":"https://avatars.githubusercontent.com/u/1147473?v=3","gravatar_id":"","url":"https://api.github.com/users/saltstack","html_url":"https://github.com/saltstack","followers_url":"https://api.github.com/users/saltstack/followers","following_url":"https://api.github.com/users/saltstack/following{/other_user}","gists_url":"https://api.github.com/users/saltstack/gists{/gist_id}","starred_url":"https://api.github.com/users/saltstack/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/saltstack/subscriptions","organizations_url":"https://api.github.com/users/saltstack/orgs","repos_url":"https://api.github.com/users/saltstack/repos","events_url":"https://api.github.com/users/saltstack/events{/privacy}","received_events_url":"https://api.github.com/users/saltstack/received_events","type":"Organization","site_admin":false},"repo":{"id":1390248,"name":"salt","full_name":"saltstack/salt","owner":{"login":"saltstack","id":1147473,"avatar_url":"https://avatars.githubusercontent.com/u/1147473?v=3","gravatar_id":"","url":"https://api.github.com/users/saltstack","html_url":"https://github.com/saltstack","followers_url":"https://api.github.com/users/saltstack/followers","following_url":"https://api.github.com/users/saltstack/following{/other_user}","gists_url":"https://api.github.com/users/saltstack/gists{/gist_id}","starred_url":"https://api.github.com/users/saltstack/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/saltstack/subscriptions","organizations_url":"https://api.github.com/users/saltstack/orgs","repos_url":"https://api.github.com/users/saltstack/repos","events_url":"https://api.github.com/users/saltstack/events{/privacy}","received_events_url":"https://api.github.com/users/saltstack/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/saltstack/salt","description":"Infrastructure automation and management system","fork":false,"url":"https://api.github.com/repos/saltstack/salt","forks_url":"https://api.github.com/repos/saltstack/salt/forks","keys_url":"https://api.github.com/repos/saltstack/salt/keys{/key_id}","collaborators_url":"https://api.github.com/repos/saltstack/salt/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/saltstack/salt/teams","hooks_url":"https://api.github.com/repos/saltstack/salt/hooks","issue_events_url":"https://api.github.com/repos/saltstack/salt/issues/events{/number}","events_url":"https://api.github.com/repos/saltstack/salt/events","assignees_url":"https://api.github.com/repos/saltstack/salt/assignees{/user}","branches_url":"https://api.github.com/repos/saltstack/salt/branches{/branch}","tags_url":"https://api.github.com/repos/saltstack/salt/tags","blobs_url":"https://api.github.com/repos/saltstack/salt/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/saltstack/salt/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/saltstack/salt/git/refs{/sha}","trees_url":"https://api.github.com/repos/saltstack/salt/git/trees{/sha}","statuses_url":"https://api.github.com/repos/saltstack/salt/statuses/{sha}","languages_url":"https://api.github.com/repos/saltstack/salt/languages","stargazers_url":"https://api.github.com/repos/saltstack/salt/stargazers","contributors_url":"https://api.github.com/repos/saltstack/salt/contributors","subscribers_url":"https://api.github.com/repos/saltstack/salt/subscribers","subscription_url":"https://api.github.com/repos/saltstack/salt/subscription","commits_url":"https://api.github.com/repos/saltstack/salt/commits{/sha}","git_commits_url":"https://api.github.com/repos/saltstack/salt/git/commits{/sha}","comments_url":"https://api.github.com/repos/saltstack/salt/comments{/number}","issue_comment_url":"https://api.github.com/repos/saltstack/salt/issues/comments{/number}","contents_url":"https://api.github.com/repos/saltstack/salt/contents/{+path}","compare_url":"https://api.github.com/repos/saltstack/salt/compare/{base}...{head}","merges_url":"https://api.github.com/repos/saltstack/salt/merges","archive_url":"https://api.github.com/repos/saltstack/salt/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/saltstack/salt/downloads","issues_url":"https://api.github.com/repos/saltstack/salt/issues{/number}","pulls_url":"https://api.github.com/repos/saltstack/salt/pulls{/number}","milestones_url":"https://api.github.com/repos/saltstack/salt/milestones{/number}","notifications_url":"https://api.github.com/repos/saltstack/salt/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/saltstack/salt/labels{/name}","releases_url":"https://api.github.com/repos/saltstack/salt/releases{/id}","created_at":"2011-02-20T20:16:56Z","updated_at":"2015-05-05T18:19:55Z","pushed_at":"2015-05-05T19:41:25Z","git_url":"git://github.com/saltstack/salt.git","ssh_url":"git@github.com:saltstack/salt.git","clone_url":"https://github.com/saltstack/salt.git","svn_url":"https://github.com/saltstack/salt","homepage":"saltstack.com","size":222198,"stargazers_count":5091,"watchers_count":5091,"language":"Python","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":2128,"mirror_url":null,"open_issues_count":2496,"forks":2128,"open_issues":2496,"watchers":5091,"default_branch":"develop"}},"_links":{"self":{"href":"https://api.github.com/repos/saltstack/salt/pulls/23387"},"html":{"href":"https://github.com/saltstack/salt/pull/23387"},"issue":{"href":"https://api.github.com/repos/saltstack/salt/issues/23387"},"comments":{"href":"https://api.github.com/repos/saltstack/salt/issues/23387/comments"},"review_comments":{"href":"https://api.github.com/repos/saltstack/salt/pulls/23387/comments"},"review_comment":{"href":"https://api.github.com/repos/saltstack/salt/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/saltstack/salt/pulls/23387/commits"},"statuses":{"href":"https://api.github.com/repos/saltstack/salt/statuses/ed788a2965bd1e4c446d42c4bf11277a6fae4492"}}}}