{"action":"created","comment":{"url":"https://api.github.com/repos/freeorion/freeorion/pulls/comments/81617107","pull_request_review_id":2584187,"id":81617107,"diff_hunk":"@@ -0,0 +1,234 @@\n+# Issue and Pull Request labels\n+\n+This document describes the intended usage of GitHub Issue and Pull Request\n+label within the FreeOrion project.  When referencing to __Issues__ inside this\n+documentation both Github Issues and Github Pull Requests are meant.\n+\n+\n+## Purpose of labels\n+\n+Labels allow to attach common search and filter terms to Issues.  This makes it\n+easier for developers, managers, reporters and to track the purpose, scope and\n+state of Issues without explicit reading through possible length of comments,\n+code reviews or commits.  Please follow this guide as close as possible to avoid\n+duplicating work and wasting time for other developers and to enable better\n+documentation on decisions made.\n+\n+\n+## Label categories\n+\n+Labels are groupd in categories.  Those categories group together a common\n+concept like the resolving state of an Issue or the target platform where the\n+Issue occurs.  Categories share a prefix in the form `category_name:label_name`\n+and are grouped together by color.  As a rule of thumb there is at least one\n+label from every category that needs to be applied to an issue but use common\n+sense to check if the label is approciate or not for the specific Issue.\n+\n+Currently there are three categories:\n+\n+\n+#### Label category `category`\n+\n+Labels within this category describe is the intention of the Issue.  Usually\n+there should be exact one intention for creating an Issue and it should not\n+change during the lifetime of an Issue.\n+\n+#### Label category `component`\n+\n+The component lists the parts of the project this Issue affects or is affected\n+by.  This should help developers to identify if they have required knowledge or\n+interests to handle the issue.  There should be at least one component listed\n+for an Issue.\n+\n+#### Label category `status`\n+\n+With the status category developers, managers or issue reporters can check if\n+an issue needs further interaction and who should carry out this interaction.\n+Issue have exactly one status.\n+\n+\n+## Labels\n+\n+This section lists when an label should be applied and what actions may be taken\n+additionally.\n+\n+\n+#### Label `category:bug`\n+\n+The Issue describes or solves a percieved malfunction within the game.\n+\n+#### Label `category:feature`\n+\n+The Pull Request contains a new game feature.  Features are parts of the game\n+which a player can interact with e.g.: A new species, a new gameplay mechanic\n+or a new command line switch for the server that changes gameplay behaviour.","path":".github/labels.md","position":64,"original_position":64,"commit_id":"005846bd318619be184e3446435d6551e0487274","original_commit_id":"005846bd318619be184e3446435d6551e0487274","user":{"login":"adrianbroher","id":84891,"avatar_url":"https://avatars.githubusercontent.com/u/84891?v=3","gravatar_id":"","url":"https://api.github.com/users/adrianbroher","html_url":"https://github.com/adrianbroher","followers_url":"https://api.github.com/users/adrianbroher/followers","following_url":"https://api.github.com/users/adrianbroher/following{/other_user}","gists_url":"https://api.github.com/users/adrianbroher/gists{/gist_id}","starred_url":"https://api.github.com/users/adrianbroher/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adrianbroher/subscriptions","organizations_url":"https://api.github.com/users/adrianbroher/orgs","repos_url":"https://api.github.com/users/adrianbroher/repos","events_url":"https://api.github.com/users/adrianbroher/events{/privacy}","received_events_url":"https://api.github.com/users/adrianbroher/received_events","type":"User","site_admin":false},"body":"Fixed.","created_at":"2016-10-03T19:01:19Z","updated_at":"2016-10-03T19:01:19Z","html_url":"https://github.com/freeorion/freeorion/pull/1020#discussion_r81617107","pull_request_url":"https://api.github.com/repos/freeorion/freeorion/pulls/1020","_links":{"self":{"href":"https://api.github.com/repos/freeorion/freeorion/pulls/comments/81617107"},"html":{"href":"https://github.com/freeorion/freeorion/pull/1020#discussion_r81617107"},"pull_request":{"href":"https://api.github.com/repos/freeorion/freeorion/pulls/1020"}}},"pull_request":{"url":"https://api.github.com/repos/freeorion/freeorion/pulls/1020","id":87710822,"html_url":"https://github.com/freeorion/freeorion/pull/1020","diff_url":"https://github.com/freeorion/freeorion/pull/1020.diff","patch_url":"https://github.com/freeorion/freeorion/pull/1020.patch","issue_url":"https://api.github.com/repos/freeorion/freeorion/issues/1020","number":1020,"state":"open","locked":false,"title":"Add documentation for the correct usage of GitHub Issue labels","user":{"login":"adrianbroher","id":84891,"avatar_url":"https://avatars.githubusercontent.com/u/84891?v=3","gravatar_id":"","url":"https://api.github.com/users/adrianbroher","html_url":"https://github.com/adrianbroher","followers_url":"https://api.github.com/users/adrianbroher/followers","following_url":"https://api.github.com/users/adrianbroher/following{/other_user}","gists_url":"https://api.github.com/users/adrianbroher/gists{/gist_id}","starred_url":"https://api.github.com/users/adrianbroher/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adrianbroher/subscriptions","organizations_url":"https://api.github.com/users/adrianbroher/orgs","repos_url":"https://api.github.com/users/adrianbroher/repos","events_url":"https://api.github.com/users/adrianbroher/events{/privacy}","received_events_url":"https://api.github.com/users/adrianbroher/received_events","type":"User","site_admin":false},"body":"This was requested in the Forums by @dbenage-cx .\r\n\r\n@Vezzra There are still some unclear labels for me. Those are marked with `???`.  Maybe you can help me with coming up for a better explanation.","created_at":"2016-10-03T12:51:40Z","updated_at":"2016-10-03T19:01:19Z","closed_at":null,"merged_at":null,"merge_commit_sha":"d7d750ca2e2cc32993115e764cc3fcba89c52270","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/freeorion/freeorion/pulls/1020/commits","review_comments_url":"https://api.github.com/repos/freeorion/freeorion/pulls/1020/comments","review_comment_url":"https://api.github.com/repos/freeorion/freeorion/pulls/comments{/number}","comments_url":"https://api.github.com/repos/freeorion/freeorion/issues/1020/comments","statuses_url":"https://api.github.com/repos/freeorion/freeorion/statuses/005846bd318619be184e3446435d6551e0487274","head":{"label":"adrianbroher:doc-gh-labels","ref":"doc-gh-labels","sha":"005846bd318619be184e3446435d6551e0487274","user":{"login":"adrianbroher","id":84891,"avatar_url":"https://avatars.githubusercontent.com/u/84891?v=3","gravatar_id":"","url":"https://api.github.com/users/adrianbroher","html_url":"https://github.com/adrianbroher","followers_url":"https://api.github.com/users/adrianbroher/followers","following_url":"https://api.github.com/users/adrianbroher/following{/other_user}","gists_url":"https://api.github.com/users/adrianbroher/gists{/gist_id}","starred_url":"https://api.github.com/users/adrianbroher/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adrianbroher/subscriptions","organizations_url":"https://api.github.com/users/adrianbroher/orgs","repos_url":"https://api.github.com/users/adrianbroher/repos","events_url":"https://api.github.com/users/adrianbroher/events{/privacy}","received_events_url":"https://api.github.com/users/adrianbroher/received_events","type":"User","site_admin":false},"repo":{"id":33496679,"name":"freeorion","full_name":"adrianbroher/freeorion","owner":{"login":"adrianbroher","id":84891,"avatar_url":"https://avatars.githubusercontent.com/u/84891?v=3","gravatar_id":"","url":"https://api.github.com/users/adrianbroher","html_url":"https://github.com/adrianbroher","followers_url":"https://api.github.com/users/adrianbroher/followers","following_url":"https://api.github.com/users/adrianbroher/following{/other_user}","gists_url":"https://api.github.com/users/adrianbroher/gists{/gist_id}","starred_url":"https://api.github.com/users/adrianbroher/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adrianbroher/subscriptions","organizations_url":"https://api.github.com/users/adrianbroher/orgs","repos_url":"https://api.github.com/users/adrianbroher/repos","events_url":"https://api.github.com/users/adrianbroher/events{/privacy}","received_events_url":"https://api.github.com/users/adrianbroher/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/adrianbroher/freeorion","description":"Private fork of FreeOrion. Spontaneous rebases happen, so don't fork.","fork":true,"url":"https://api.github.com/repos/adrianbroher/freeorion","forks_url":"https://api.github.com/repos/adrianbroher/freeorion/forks","keys_url":"https://api.github.com/repos/adrianbroher/freeorion/keys{/key_id}","collaborators_url":"https://api.github.com/repos/adrianbroher/freeorion/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/adrianbroher/freeorion/teams","hooks_url":"https://api.github.com/repos/adrianbroher/freeorion/hooks","issue_events_url":"https://api.github.com/repos/adrianbroher/freeorion/issues/events{/number}","events_url":"https://api.github.com/repos/adrianbroher/freeorion/events","assignees_url":"https://api.github.com/repos/adrianbroher/freeorion/assignees{/user}","branches_url":"https://api.github.com/repos/adrianbroher/freeorion/branches{/branch}","tags_url":"https://api.github.com/repos/adrianbroher/freeorion/tags","blobs_url":"https://api.github.com/repos/adrianbroher/freeorion/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/adrianbroher/freeorion/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/adrianbroher/freeorion/git/refs{/sha}","trees_url":"https://api.github.com/repos/adrianbroher/freeorion/git/trees{/sha}","statuses_url":"https://api.github.com/repos/adrianbroher/freeorion/statuses/{sha}","languages_url":"https://api.github.com/repos/adrianbroher/freeorion/languages","stargazers_url":"https://api.github.com/repos/adrianbroher/freeorion/stargazers","contributors_url":"https://api.github.com/repos/adrianbroher/freeorion/contributors","subscribers_url":"https://api.github.com/repos/adrianbroher/freeorion/subscribers","subscription_url":"https://api.github.com/repos/adrianbroher/freeorion/subscription","commits_url":"https://api.github.com/repos/adrianbroher/freeorion/commits{/sha}","git_commits_url":"https://api.github.com/repos/adrianbroher/freeorion/git/commits{/sha}","comments_url":"https://api.github.com/repos/adrianbroher/freeorion/comments{/number}","issue_comment_url":"https://api.github.com/repos/adrianbroher/freeorion/issues/comments{/number}","contents_url":"https://api.github.com/repos/adrianbroher/freeorion/contents/{+path}","compare_url":"https://api.github.com/repos/adrianbroher/freeorion/compare/{base}...{head}","merges_url":"https://api.github.com/repos/adrianbroher/freeorion/merges","archive_url":"https://api.github.com/repos/adrianbroher/freeorion/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/adrianbroher/freeorion/downloads","issues_url":"https://api.github.com/repos/adrianbroher/freeorion/issues{/number}","pulls_url":"https://api.github.com/repos/adrianbroher/freeorion/pulls{/number}","milestones_url":"https://api.github.com/repos/adrianbroher/freeorion/milestones{/number}","notifications_url":"https://api.github.com/repos/adrianbroher/freeorion/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/adrianbroher/freeorion/labels{/name}","releases_url":"https://api.github.com/repos/adrianbroher/freeorion/releases{/id}","deployments_url":"https://api.github.com/repos/adrianbroher/freeorion/deployments","created_at":"2015-04-06T18:01:40Z","updated_at":"2016-01-28T08:04:23Z","pushed_at":"2016-10-03T12:47:40Z","git_url":"git://github.com/adrianbroher/freeorion.git","ssh_url":"git@github.com:adrianbroher/freeorion.git","clone_url":"https://github.com/adrianbroher/freeorion.git","svn_url":"https://github.com/adrianbroher/freeorion","homepage":"http://www.freeorion.org/","size":520959,"stargazers_count":0,"watchers_count":0,"language":"C++","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"freeorion:master","ref":"master","sha":"9cc18835ccb6d35244a62a0e5a970de84688b08c","user":{"login":"freeorion","id":1025550,"avatar_url":"https://avatars.githubusercontent.com/u/1025550?v=3","gravatar_id":"","url":"https://api.github.com/users/freeorion","html_url":"https://github.com/freeorion","followers_url":"https://api.github.com/users/freeorion/followers","following_url":"https://api.github.com/users/freeorion/following{/other_user}","gists_url":"https://api.github.com/users/freeorion/gists{/gist_id}","starred_url":"https://api.github.com/users/freeorion/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/freeorion/subscriptions","organizations_url":"https://api.github.com/users/freeorion/orgs","repos_url":"https://api.github.com/users/freeorion/repos","events_url":"https://api.github.com/users/freeorion/events{/privacy}","received_events_url":"https://api.github.com/users/freeorion/received_events","type":"Organization","site_admin":false},"repo":{"id":33066062,"name":"freeorion","full_name":"freeorion/freeorion","owner":{"login":"freeorion","id":1025550,"avatar_url":"https://avatars.githubusercontent.com/u/1025550?v=3","gravatar_id":"","url":"https://api.github.com/users/freeorion","html_url":"https://github.com/freeorion","followers_url":"https://api.github.com/users/freeorion/followers","following_url":"https://api.github.com/users/freeorion/following{/other_user}","gists_url":"https://api.github.com/users/freeorion/gists{/gist_id}","starred_url":"https://api.github.com/users/freeorion/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/freeorion/subscriptions","organizations_url":"https://api.github.com/users/freeorion/orgs","repos_url":"https://api.github.com/users/freeorion/repos","events_url":"https://api.github.com/users/freeorion/events{/privacy}","received_events_url":"https://api.github.com/users/freeorion/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/freeorion/freeorion","description":"Source code repository of the FreeOrion project.","fork":false,"url":"https://api.github.com/repos/freeorion/freeorion","forks_url":"https://api.github.com/repos/freeorion/freeorion/forks","keys_url":"https://api.github.com/repos/freeorion/freeorion/keys{/key_id}","collaborators_url":"https://api.github.com/repos/freeorion/freeorion/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/freeorion/freeorion/teams","hooks_url":"https://api.github.com/repos/freeorion/freeorion/hooks","issue_events_url":"https://api.github.com/repos/freeorion/freeorion/issues/events{/number}","events_url":"https://api.github.com/repos/freeorion/freeorion/events","assignees_url":"https://api.github.com/repos/freeorion/freeorion/assignees{/user}","branches_url":"https://api.github.com/repos/freeorion/freeorion/branches{/branch}","tags_url":"https://api.github.com/repos/freeorion/freeorion/tags","blobs_url":"https://api.github.com/repos/freeorion/freeorion/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/freeorion/freeorion/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/freeorion/freeorion/git/refs{/sha}","trees_url":"https://api.github.com/repos/freeorion/freeorion/git/trees{/sha}","statuses_url":"https://api.github.com/repos/freeorion/freeorion/statuses/{sha}","languages_url":"https://api.github.com/repos/freeorion/freeorion/languages","stargazers_url":"https://api.github.com/repos/freeorion/freeorion/stargazers","contributors_url":"https://api.github.com/repos/freeorion/freeorion/contributors","subscribers_url":"https://api.github.com/repos/freeorion/freeorion/subscribers","subscription_url":"https://api.github.com/repos/freeorion/freeorion/subscription","commits_url":"https://api.github.com/repos/freeorion/freeorion/commits{/sha}","git_commits_url":"https://api.github.com/repos/freeorion/freeorion/git/commits{/sha}","comments_url":"https://api.github.com/repos/freeorion/freeorion/comments{/number}","issue_comment_url":"https://api.github.com/repos/freeorion/freeorion/issues/comments{/number}","contents_url":"https://api.github.com/repos/freeorion/freeorion/contents/{+path}","compare_url":"https://api.github.com/repos/freeorion/freeorion/compare/{base}...{head}","merges_url":"https://api.github.com/repos/freeorion/freeorion/merges","archive_url":"https://api.github.com/repos/freeorion/freeorion/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/freeorion/freeorion/downloads","issues_url":"https://api.github.com/repos/freeorion/freeorion/issues{/number}","pulls_url":"https://api.github.com/repos/freeorion/freeorion/pulls{/number}","milestones_url":"https://api.github.com/repos/freeorion/freeorion/milestones{/number}","notifications_url":"https://api.github.com/repos/freeorion/freeorion/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/freeorion/freeorion/labels{/name}","releases_url":"https://api.github.com/repos/freeorion/freeorion/releases{/id}","deployments_url":"https://api.github.com/repos/freeorion/freeorion/deployments","created_at":"2015-03-29T08:22:20Z","updated_at":"2016-10-03T16:59:21Z","pushed_at":"2016-10-03T18:04:27Z","git_url":"git://github.com/freeorion/freeorion.git","ssh_url":"git@github.com:freeorion/freeorion.git","clone_url":"https://github.com/freeorion/freeorion.git","svn_url":"https://github.com/freeorion/freeorion","homepage":"http://www.freeorion.org/","size":540490,"stargazers_count":169,"watchers_count":169,"language":"C++","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":62,"mirror_url":null,"open_issues_count":138,"forks":62,"open_issues":138,"watchers":169,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/freeorion/freeorion/pulls/1020"},"html":{"href":"https://github.com/freeorion/freeorion/pull/1020"},"issue":{"href":"https://api.github.com/repos/freeorion/freeorion/issues/1020"},"comments":{"href":"https://api.github.com/repos/freeorion/freeorion/issues/1020/comments"},"review_comments":{"href":"https://api.github.com/repos/freeorion/freeorion/pulls/1020/comments"},"review_comment":{"href":"https://api.github.com/repos/freeorion/freeorion/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/freeorion/freeorion/pulls/1020/commits"},"statuses":{"href":"https://api.github.com/repos/freeorion/freeorion/statuses/005846bd318619be184e3446435d6551e0487274"}}}}
{"actor":{"display_login":"adrianbroher"}}