{"action":"created","comment":{"url":"https://api.github.com/repos/ipfs/community/pulls/comments/29552728","id":29552728,"diff_hunk":"@@ -0,0 +1,100 @@\n+Issues Guide\n+=============\n+This is a guide for collaborators and non-collaborators on how Github issues\n+are handled and processed. \n+\n+\n+The Sprint\n+-----------\n+We are on a weekly sprint cycle and every Monday we get together for a meeting\n+on Google Hangouts. Currently our meetings are at 12pm PDT / 7pm UTC and the \n+link is always\n+posted to the IRC channel. This is where collaborators are assigned tasks and \n+issues to work on for the week. Note that anyone can become a collaborator and \n+all they have to do is contact\n+[@jbenet](https://github.com/jbenet) and join in on a sprint meeting. On the \n+rest of the days when we aren't meeting on \n+Google Hangouts we have a \"standup\" at the same time in the IRC channel. This is\n+a time where everyone is on the channel at once so we can sync up and bring up \n+any topics that need to be discussed. \n+\n+\n+Github Labels\n+--------------\n+We make extensive use of Github labels to help us and our tools organize issues.\n+Here is a rough guide.\n+\n+__The colors:__  \n+* blue: topic / subsystem  \n+* light red (important topic): security things  \n+* red (very important): bugs!!  \n+* orange (important): cleanup / refactor things  \n+* light green: the difficulty level  \n+* dark green: testing  \n+* yellow: documentation  \n+* gray labels: used by tools like [waffle.io](https://waffle.io/ipfs/ipfs)  \n+\n+__Naming:__  \n+It's very ad-hoc with no strict science. Generally, the names should be\n+understandable by themselves. For example, use \"difficulty: medium\" instead\n+of \"medium\".\n+\n+\n+Waffle\n+-------\n+[Waffle](https://waffle.io/ipfs/ipfs) is our issue board and is divided into \n+7 columns:\n+* New Issues: This is pretty self explanatory and is where all the new issues\n+    get thrown into.\n+* Icebox: These are issues we've decided that aren't important for now, but\n+    will want to get to some day.\n+* Backlog: These are the issues that are ready for work to begin on and we \n+    will pull from these when determining what to work on for \n+    the next sprint cycle.\n+* Sprint: These are the issues that are being tackled for the current sprint.\n+* In Progress: These are the issues that people are working on at the current\n+    point in time.\n+* Code Review & QA: These are the issues where work has been completed for \n+    and are awaiting approval to be merged or closed.\n+* Done: All the issues that have been closed in the past week.\n+\n+\n+Issue Workflow Example\n+-----------------------\n+### New issue submitted\n+1. The issue is submitted:\n+    * The issue gets sent to the New Issues column in waffle.\n+    * A collaborator on the repo intercepts the issue and begins discussion on\n+      the issue.\n+2. The issue has been sufficiently described for work to begin:\n+   * If work should begin soon on the issue then a collaborator moves the issue\n+     to the backlog column, else if the issue should be held off from work for\n+     a later time then it is moved to the Icebox column.\n+3. In a sprint meeting, a collaborator decides to work on an issue:\n+    * The issue is moved to the Sprint column and assigned an owner.","path":"issues-guide.md","position":74,"original_position":74,"commit_id":"0b5280bd321c2f36c93398ae83b2f26114119d42","original_commit_id":"0b5280bd321c2f36c93398ae83b2f26114119d42","user":{"login":"wking","id":209920,"avatar_url":"https://avatars.githubusercontent.com/u/209920?v=3","gravatar_id":"","url":"https://api.github.com/users/wking","html_url":"https://github.com/wking","followers_url":"https://api.github.com/users/wking/followers","following_url":"https://api.github.com/users/wking/following{/other_user}","gists_url":"https://api.github.com/users/wking/gists{/gist_id}","starred_url":"https://api.github.com/users/wking/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/wking/subscriptions","organizations_url":"https://api.github.com/users/wking/orgs","repos_url":"https://api.github.com/users/wking/repos","events_url":"https://api.github.com/users/wking/events{/privacy}","received_events_url":"https://api.github.com/users/wking/received_events","type":"User","site_admin":false},"body":"What if non-collaborators are working on an issue?  It seems like you need to have [write access to the relevant repository][1] before you can adjust issue labels, and Waffle needs that for shifting stuff between columns.\r\n\r\n[1]: https://help.github.com/articles/permission-levels-for-an-organization-repository/","created_at":"2015-05-03T03:54:37Z","updated_at":"2015-05-03T03:54:37Z","html_url":"https://github.com/ipfs/community/pull/20#discussion_r29552728","pull_request_url":"https://api.github.com/repos/ipfs/community/pulls/20","_links":{"self":{"href":"https://api.github.com/repos/ipfs/community/pulls/comments/29552728"},"html":{"href":"https://github.com/ipfs/community/pull/20#discussion_r29552728"},"pull_request":{"href":"https://api.github.com/repos/ipfs/community/pulls/20"}}},"pull_request":{"url":"https://api.github.com/repos/ipfs/community/pulls/20","id":34594412,"html_url":"https://github.com/ipfs/community/pull/20","diff_url":"https://github.com/ipfs/community/pull/20.diff","patch_url":"https://github.com/ipfs/community/pull/20.patch","issue_url":"https://api.github.com/repos/ipfs/community/issues/20","number":20,"state":"open","locked":false,"title":"Issues guide","user":{"login":"dylanPowers","id":1594851,"avatar_url":"https://avatars.githubusercontent.com/u/1594851?v=3","gravatar_id":"","url":"https://api.github.com/users/dylanPowers","html_url":"https://github.com/dylanPowers","followers_url":"https://api.github.com/users/dylanPowers/followers","following_url":"https://api.github.com/users/dylanPowers/following{/other_user}","gists_url":"https://api.github.com/users/dylanPowers/gists{/gist_id}","starred_url":"https://api.github.com/users/dylanPowers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dylanPowers/subscriptions","organizations_url":"https://api.github.com/users/dylanPowers/orgs","repos_url":"https://api.github.com/users/dylanPowers/repos","events_url":"https://api.github.com/users/dylanPowers/events{/privacy}","received_events_url":"https://api.github.com/users/dylanPowers/received_events","type":"User","site_admin":false},"body":"Fixes #10 \r\nFixes https://github.com/ipfs/infrastructure/issues/8\r\nAdded in a guide for collaborators and non-collaborators on how Github issues are handled and processed. ","created_at":"2015-05-03T00:45:24Z","updated_at":"2015-05-03T03:54:37Z","closed_at":null,"merged_at":null,"merge_commit_sha":"8bb0bd0c257865ec868d0092784b2af571318630","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/ipfs/community/pulls/20/commits","review_comments_url":"https://api.github.com/repos/ipfs/community/pulls/20/comments","review_comment_url":"https://api.github.com/repos/ipfs/community/pulls/comments{/number}","comments_url":"https://api.github.com/repos/ipfs/community/issues/20/comments","statuses_url":"https://api.github.com/repos/ipfs/community/statuses/0b5280bd321c2f36c93398ae83b2f26114119d42","head":{"label":"dylanPowers:issues-guide","ref":"issues-guide","sha":"0b5280bd321c2f36c93398ae83b2f26114119d42","user":{"login":"dylanPowers","id":1594851,"avatar_url":"https://avatars.githubusercontent.com/u/1594851?v=3","gravatar_id":"","url":"https://api.github.com/users/dylanPowers","html_url":"https://github.com/dylanPowers","followers_url":"https://api.github.com/users/dylanPowers/followers","following_url":"https://api.github.com/users/dylanPowers/following{/other_user}","gists_url":"https://api.github.com/users/dylanPowers/gists{/gist_id}","starred_url":"https://api.github.com/users/dylanPowers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dylanPowers/subscriptions","organizations_url":"https://api.github.com/users/dylanPowers/orgs","repos_url":"https://api.github.com/users/dylanPowers/repos","events_url":"https://api.github.com/users/dylanPowers/events{/privacy}","received_events_url":"https://api.github.com/users/dylanPowers/received_events","type":"User","site_admin":false},"repo":{"id":32895613,"name":"ipfs-community","full_name":"dylanPowers/ipfs-community","owner":{"login":"dylanPowers","id":1594851,"avatar_url":"https://avatars.githubusercontent.com/u/1594851?v=3","gravatar_id":"","url":"https://api.github.com/users/dylanPowers","html_url":"https://github.com/dylanPowers","followers_url":"https://api.github.com/users/dylanPowers/followers","following_url":"https://api.github.com/users/dylanPowers/following{/other_user}","gists_url":"https://api.github.com/users/dylanPowers/gists{/gist_id}","starred_url":"https://api.github.com/users/dylanPowers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dylanPowers/subscriptions","organizations_url":"https://api.github.com/users/dylanPowers/orgs","repos_url":"https://api.github.com/users/dylanPowers/repos","events_url":"https://api.github.com/users/dylanPowers/events{/privacy}","received_events_url":"https://api.github.com/users/dylanPowers/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/dylanPowers/ipfs-community","description":"IPFS community","fork":true,"url":"https://api.github.com/repos/dylanPowers/ipfs-community","forks_url":"https://api.github.com/repos/dylanPowers/ipfs-community/forks","keys_url":"https://api.github.com/repos/dylanPowers/ipfs-community/keys{/key_id}","collaborators_url":"https://api.github.com/repos/dylanPowers/ipfs-community/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/dylanPowers/ipfs-community/teams","hooks_url":"https://api.github.com/repos/dylanPowers/ipfs-community/hooks","issue_events_url":"https://api.github.com/repos/dylanPowers/ipfs-community/issues/events{/number}","events_url":"https://api.github.com/repos/dylanPowers/ipfs-community/events","assignees_url":"https://api.github.com/repos/dylanPowers/ipfs-community/assignees{/user}","branches_url":"https://api.github.com/repos/dylanPowers/ipfs-community/branches{/branch}","tags_url":"https://api.github.com/repos/dylanPowers/ipfs-community/tags","blobs_url":"https://api.github.com/repos/dylanPowers/ipfs-community/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/dylanPowers/ipfs-community/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/dylanPowers/ipfs-community/git/refs{/sha}","trees_url":"https://api.github.com/repos/dylanPowers/ipfs-community/git/trees{/sha}","statuses_url":"https://api.github.com/repos/dylanPowers/ipfs-community/statuses/{sha}","languages_url":"https://api.github.com/repos/dylanPowers/ipfs-community/languages","stargazers_url":"https://api.github.com/repos/dylanPowers/ipfs-community/stargazers","contributors_url":"https://api.github.com/repos/dylanPowers/ipfs-community/contributors","subscribers_url":"https://api.github.com/repos/dylanPowers/ipfs-community/subscribers","subscription_url":"https://api.github.com/repos/dylanPowers/ipfs-community/subscription","commits_url":"https://api.github.com/repos/dylanPowers/ipfs-community/commits{/sha}","git_commits_url":"https://api.github.com/repos/dylanPowers/ipfs-community/git/commits{/sha}","comments_url":"https://api.github.com/repos/dylanPowers/ipfs-community/comments{/number}","issue_comment_url":"https://api.github.com/repos/dylanPowers/ipfs-community/issues/comments{/number}","contents_url":"https://api.github.com/repos/dylanPowers/ipfs-community/contents/{+path}","compare_url":"https://api.github.com/repos/dylanPowers/ipfs-community/compare/{base}...{head}","merges_url":"https://api.github.com/repos/dylanPowers/ipfs-community/merges","archive_url":"https://api.github.com/repos/dylanPowers/ipfs-community/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/dylanPowers/ipfs-community/downloads","issues_url":"https://api.github.com/repos/dylanPowers/ipfs-community/issues{/number}","pulls_url":"https://api.github.com/repos/dylanPowers/ipfs-community/pulls{/number}","milestones_url":"https://api.github.com/repos/dylanPowers/ipfs-community/milestones{/number}","notifications_url":"https://api.github.com/repos/dylanPowers/ipfs-community/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/dylanPowers/ipfs-community/labels{/name}","releases_url":"https://api.github.com/repos/dylanPowers/ipfs-community/releases{/id}","created_at":"2015-03-25T22:53:19Z","updated_at":"2015-05-01T22:26:24Z","pushed_at":"2015-05-03T00:45:14Z","git_url":"git://github.com/dylanPowers/ipfs-community.git","ssh_url":"git@github.com:dylanPowers/ipfs-community.git","clone_url":"https://github.com/dylanPowers/ipfs-community.git","svn_url":"https://github.com/dylanPowers/ipfs-community","homepage":"http://ipfs.io","size":171,"stargazers_count":0,"watchers_count":0,"language":"Shell","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":"master"}},"base":{"label":"ipfs:master","ref":"master","sha":"217496cb08d4827b6b048c2d792ec7627cbdabbb","user":{"login":"ipfs","id":10536621,"avatar_url":"https://avatars.githubusercontent.com/u/10536621?v=3","gravatar_id":"","url":"https://api.github.com/users/ipfs","html_url":"https://github.com/ipfs","followers_url":"https://api.github.com/users/ipfs/followers","following_url":"https://api.github.com/users/ipfs/following{/other_user}","gists_url":"https://api.github.com/users/ipfs/gists{/gist_id}","starred_url":"https://api.github.com/users/ipfs/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ipfs/subscriptions","organizations_url":"https://api.github.com/users/ipfs/orgs","repos_url":"https://api.github.com/users/ipfs/repos","events_url":"https://api.github.com/users/ipfs/events{/privacy}","received_events_url":"https://api.github.com/users/ipfs/received_events","type":"Organization","site_admin":false},"repo":{"id":32509278,"name":"community","full_name":"ipfs/community","owner":{"login":"ipfs","id":10536621,"avatar_url":"https://avatars.githubusercontent.com/u/10536621?v=3","gravatar_id":"","url":"https://api.github.com/users/ipfs","html_url":"https://github.com/ipfs","followers_url":"https://api.github.com/users/ipfs/followers","following_url":"https://api.github.com/users/ipfs/following{/other_user}","gists_url":"https://api.github.com/users/ipfs/gists{/gist_id}","starred_url":"https://api.github.com/users/ipfs/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ipfs/subscriptions","organizations_url":"https://api.github.com/users/ipfs/orgs","repos_url":"https://api.github.com/users/ipfs/repos","events_url":"https://api.github.com/users/ipfs/events{/privacy}","received_events_url":"https://api.github.com/users/ipfs/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/ipfs/community","description":"General discussion and documentation on community practices","fork":false,"url":"https://api.github.com/repos/ipfs/community","forks_url":"https://api.github.com/repos/ipfs/community/forks","keys_url":"https://api.github.com/repos/ipfs/community/keys{/key_id}","collaborators_url":"https://api.github.com/repos/ipfs/community/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/ipfs/community/teams","hooks_url":"https://api.github.com/repos/ipfs/community/hooks","issue_events_url":"https://api.github.com/repos/ipfs/community/issues/events{/number}","events_url":"https://api.github.com/repos/ipfs/community/events","assignees_url":"https://api.github.com/repos/ipfs/community/assignees{/user}","branches_url":"https://api.github.com/repos/ipfs/community/branches{/branch}","tags_url":"https://api.github.com/repos/ipfs/community/tags","blobs_url":"https://api.github.com/repos/ipfs/community/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/ipfs/community/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/ipfs/community/git/refs{/sha}","trees_url":"https://api.github.com/repos/ipfs/community/git/trees{/sha}","statuses_url":"https://api.github.com/repos/ipfs/community/statuses/{sha}","languages_url":"https://api.github.com/repos/ipfs/community/languages","stargazers_url":"https://api.github.com/repos/ipfs/community/stargazers","contributors_url":"https://api.github.com/repos/ipfs/community/contributors","subscribers_url":"https://api.github.com/repos/ipfs/community/subscribers","subscription_url":"https://api.github.com/repos/ipfs/community/subscription","commits_url":"https://api.github.com/repos/ipfs/community/commits{/sha}","git_commits_url":"https://api.github.com/repos/ipfs/community/git/commits{/sha}","comments_url":"https://api.github.com/repos/ipfs/community/comments{/number}","issue_comment_url":"https://api.github.com/repos/ipfs/community/issues/comments{/number}","contents_url":"https://api.github.com/repos/ipfs/community/contents/{+path}","compare_url":"https://api.github.com/repos/ipfs/community/compare/{base}...{head}","merges_url":"https://api.github.com/repos/ipfs/community/merges","archive_url":"https://api.github.com/repos/ipfs/community/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/ipfs/community/downloads","issues_url":"https://api.github.com/repos/ipfs/community/issues{/number}","pulls_url":"https://api.github.com/repos/ipfs/community/pulls{/number}","milestones_url":"https://api.github.com/repos/ipfs/community/milestones{/number}","notifications_url":"https://api.github.com/repos/ipfs/community/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/ipfs/community/labels{/name}","releases_url":"https://api.github.com/repos/ipfs/community/releases{/id}","created_at":"2015-03-19T08:25:03Z","updated_at":"2015-05-01T05:05:07Z","pushed_at":"2015-05-03T00:45:24Z","git_url":"git://github.com/ipfs/community.git","ssh_url":"git@github.com:ipfs/community.git","clone_url":"https://github.com/ipfs/community.git","svn_url":"https://github.com/ipfs/community","homepage":"http://ipfs.io","size":246,"stargazers_count":6,"watchers_count":6,"language":"Shell","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":3,"mirror_url":null,"open_issues_count":8,"forks":3,"open_issues":8,"watchers":6,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/ipfs/community/pulls/20"},"html":{"href":"https://github.com/ipfs/community/pull/20"},"issue":{"href":"https://api.github.com/repos/ipfs/community/issues/20"},"comments":{"href":"https://api.github.com/repos/ipfs/community/issues/20/comments"},"review_comments":{"href":"https://api.github.com/repos/ipfs/community/pulls/20/comments"},"review_comment":{"href":"https://api.github.com/repos/ipfs/community/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/ipfs/community/pulls/20/commits"},"statuses":{"href":"https://api.github.com/repos/ipfs/community/statuses/0b5280bd321c2f36c93398ae83b2f26114119d42"}}}}