{"action":"created","comment":{"url":"https://api.github.com/repos/docker/distribution/pulls/comments/30853158","id":30853158,"diff_hunk":"@@ -1,57 +1,95 @@\n # Contributing to the registry\n \n-## Are you having issues?\n+## Before reporting an issue...\n \n-Please first try any of these support forums before opening an issue:\n+### If your problem is with...\n \n- * irc #docker on freenode (archives: [https://botbot.me/freenode/docker/])\n- * https://forums.docker.com/\n- * if your problem is with the \"hub\" (the website and other user-facing components), or about automated builds, then please direct your issues to https://support.docker.com\n+ - [ ] automated builds\n+ - [ ] your account on the [Docker Hub](https://hub.docker.com/)\n+ - [ ] any other [Docker Hub](https://hub.docker.com/) issue\n \n-## So, you found a bug?\n+Then please do not report your issue here - you should instead report it to [https://support.docker.com]\n \n-First check if your problem was already reported in the issue tracker.\n+### If you...\n \n-If it's already there, please refrain from adding \"same here\" comments - these don't add any value and are only adding useless noise. **Said comments will quite often be deleted at sight**. On the other hand, if you have any technical, relevant information to add, by all means do!\n+ - [ ] need help setting up your registry\n+ - [ ] can't figure out something\n+ - [ ] are not sure what's going on or what your problem is\n \n-Your issue is not there? Then please, create a ticket.\n+Then please do not open an issue here yet - you should first try one of the following support forums:\n \n-If possible the following guidelines should be followed:\n+ * irc: #docker-distribution on freenode\n+ * mailing-list: <distribution@dockerproject.org> or https://groups.google.com/a/dockerproject.org/forum/#!forum/distribution\n \n- * try to come up with a minimal, simple to reproduce test-case\n- * try to add a title that describe succinctly the issue\n- * if you are running your own registry, please provide:\n-  * registry version\n-  * registry launch command used\n-  * registry configuration\n-  * registry logs\n- * in all cases:\n-  * `docker version` and `docker info`\n-  * run your docker daemon in debug mode (-D), and provide docker daemon logs \n+## Reporting an issue properly\n \n-## You have a patch for a known bug, or a small correction?\n+By following these simple rules you will get better and faster feedback on your issue.\n \n-Basic github workflow (fork, patch, make sure the tests pass, PR).\n+ - [ ] search the bugtracker for an already reported issue\n \n-... and some simple rules to ensure quick merge:\n+### If you found an issue that describes your problem:\n \n- * clearly point to the issue(s) you want to fix\n- * when possible, prefer multiple (smaller) PRs addressing individual issues over a big one trying to address multiple issues at once\n- * if you need to amend your PR following comments, squash instead of adding more commits\n+ - [ ] please read other user comments first, and confirm this is the same issue: a given error condition might be indicative of different problems - you may also find a workaround in the comments\n+ - [ ] please refrain from adding \"same thing here\" or \"+1\" comments\n+ - [ ] you don't need to comment on an issue to get notified of updates: just hit the \"subscribe\" button\n+ - [ ] comment if you have some new, technical and relevant information to add to the case\n \n-## You want some shiny new feature to be added?\n+### If you have not found an existing issue that describes your problem:\n \n-Fork the project.\n+ - [ ] create a new issue, with a succinct title that describes your issue:\n+   * bad title: \"It doesn't work with my docker\"\n+   * good title: \"Private registry push fail: 400 error with E_INVALID_DIGEST\"\n+ - [ ] copy the output of `docker version`\n+ - [ ] copy the output of `docker info`\n+ - [ ] copy your Registry version\n+ - [ ] copy the command line you used to launch your Registry\n+ - [ ] restart your docker daemon in debug mode (add `-D` to the daemon launch arguments)\n+ - [ ] reproduce your problem and get your docker daemon logs showing the error\n+ - [ ] if relevant, copy your registry logs that show the error\n+ - [ ] provide any relevant detail about your specific Registry configuration (eg: storage backend used)\n+ - [ ] indicate if you are using an enterprise proxy, Nginx, or anything else between you and your Registry\n \n-Create a new proposal in the folder `open-design/specs`, named `DEP_MY_AWESOME_PROPOSAL.md`, using `open-design/specs/TEMPLATE.md` as a starting point.\n+## Contributing a patch for a known bug, or a small correction\n \n-Then immediately submit this new file as a pull-request, in order to get early feedback.\n+You should follow the basic GitHub workflow:\n \n-Eventually, you will have to update your proposal to accommodate the feedback you received.\n+ - [ ] fork\n+ - [ ] commit a change","path":"CONTRIBUTING.md","position":88,"original_position":88,"commit_id":"c3c888db5a55c94cbaec70737c5178f0a402b5ea","original_commit_id":"c3c888db5a55c94cbaec70737c5178f0a402b5ea","user":{"login":"thaJeztah","id":1804568,"avatar_url":"https://avatars.githubusercontent.com/u/1804568?v=3","gravatar_id":"","url":"https://api.github.com/users/thaJeztah","html_url":"https://github.com/thaJeztah","followers_url":"https://api.github.com/users/thaJeztah/followers","following_url":"https://api.github.com/users/thaJeztah/following{/other_user}","gists_url":"https://api.github.com/users/thaJeztah/gists{/gist_id}","starred_url":"https://api.github.com/users/thaJeztah/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/thaJeztah/subscriptions","organizations_url":"https://api.github.com/users/thaJeztah/orgs","repos_url":"https://api.github.com/users/thaJeztah/repos","events_url":"https://api.github.com/users/thaJeztah/events{/privacy}","received_events_url":"https://api.github.com/users/thaJeztah/received_events","type":"User","site_admin":false},"body":"Create a branch for your PR?","created_at":"2015-05-21T22:08:34Z","updated_at":"2015-05-21T22:08:34Z","html_url":"https://github.com/docker/distribution/pull/545#discussion_r30853158","pull_request_url":"https://api.github.com/repos/docker/distribution/pulls/545","_links":{"self":{"href":"https://api.github.com/repos/docker/distribution/pulls/comments/30853158"},"html":{"href":"https://github.com/docker/distribution/pull/545#discussion_r30853158"},"pull_request":{"href":"https://api.github.com/repos/docker/distribution/pulls/545"}}},"pull_request":{"url":"https://api.github.com/repos/docker/distribution/pulls/545","id":35900057,"html_url":"https://github.com/docker/distribution/pull/545","diff_url":"https://github.com/docker/distribution/pull/545.diff","patch_url":"https://github.com/docker/distribution/pull/545.patch","issue_url":"https://api.github.com/repos/docker/distribution/issues/545","number":545,"state":"open","locked":false,"title":"Enhance CONTRIBUTING","user":{"login":"dmp42","id":332946,"avatar_url":"https://avatars.githubusercontent.com/u/332946?v=3","gravatar_id":"","url":"https://api.github.com/users/dmp42","html_url":"https://github.com/dmp42","followers_url":"https://api.github.com/users/dmp42/followers","following_url":"https://api.github.com/users/dmp42/following{/other_user}","gists_url":"https://api.github.com/users/dmp42/gists{/gist_id}","starred_url":"https://api.github.com/users/dmp42/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dmp42/subscriptions","organizations_url":"https://api.github.com/users/dmp42/orgs","repos_url":"https://api.github.com/users/dmp42/repos","events_url":"https://api.github.com/users/dmp42/events{/privacy}","received_events_url":"https://api.github.com/users/dmp42/received_events","type":"User","site_admin":false},"body":"Fixes #377\r\n\r\nAlso:\r\n\r\n * re-express the bug reporting workflow with clear steps and checklists we can link to\r\n * simplified a couple of things\r\n * removed references to waffle\r\n * remove section about PR title","created_at":"2015-05-21T05:01:55Z","updated_at":"2015-05-21T22:08:34Z","closed_at":null,"merged_at":null,"merge_commit_sha":"c68a05952d45afc1db10bc9c17fc94517d9a39fa","assignee":null,"milestone":{"url":"https://api.github.com/repos/docker/distribution/milestones/8","html_url":"https://github.com/docker/distribution/milestones/Registry/2.1","labels_url":"https://api.github.com/repos/docker/distribution/milestones/8/labels","id":1026598,"number":8,"title":"Registry/2.1","description":"Items in this roadmap will be part of the registry 2.1 release.","creator":{"login":"stevvooe","id":120601,"avatar_url":"https://avatars.githubusercontent.com/u/120601?v=3","gravatar_id":"","url":"https://api.github.com/users/stevvooe","html_url":"https://github.com/stevvooe","followers_url":"https://api.github.com/users/stevvooe/followers","following_url":"https://api.github.com/users/stevvooe/following{/other_user}","gists_url":"https://api.github.com/users/stevvooe/gists{/gist_id}","starred_url":"https://api.github.com/users/stevvooe/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/stevvooe/subscriptions","organizations_url":"https://api.github.com/users/stevvooe/orgs","repos_url":"https://api.github.com/users/stevvooe/repos","events_url":"https://api.github.com/users/stevvooe/events{/privacy}","received_events_url":"https://api.github.com/users/stevvooe/received_events","type":"User","site_admin":false},"open_issues":20,"closed_issues":20,"state":"open","created_at":"2015-03-18T04:15:41Z","updated_at":"2015-05-21T18:41:04Z","due_on":"2015-06-25T07:00:00Z","closed_at":null},"commits_url":"https://api.github.com/repos/docker/distribution/pulls/545/commits","review_comments_url":"https://api.github.com/repos/docker/distribution/pulls/545/comments","review_comment_url":"https://api.github.com/repos/docker/distribution/pulls/comments{/number}","comments_url":"https://api.github.com/repos/docker/distribution/issues/545/comments","statuses_url":"https://api.github.com/repos/docker/distribution/statuses/c3c888db5a55c94cbaec70737c5178f0a402b5ea","head":{"label":"dmp42:contributing","ref":"contributing","sha":"c3c888db5a55c94cbaec70737c5178f0a402b5ea","user":{"login":"dmp42","id":332946,"avatar_url":"https://avatars.githubusercontent.com/u/332946?v=3","gravatar_id":"","url":"https://api.github.com/users/dmp42","html_url":"https://github.com/dmp42","followers_url":"https://api.github.com/users/dmp42/followers","following_url":"https://api.github.com/users/dmp42/following{/other_user}","gists_url":"https://api.github.com/users/dmp42/gists{/gist_id}","starred_url":"https://api.github.com/users/dmp42/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dmp42/subscriptions","organizations_url":"https://api.github.com/users/dmp42/orgs","repos_url":"https://api.github.com/users/dmp42/repos","events_url":"https://api.github.com/users/dmp42/events{/privacy}","received_events_url":"https://api.github.com/users/dmp42/received_events","type":"User","site_admin":false},"repo":{"id":35895395,"name":"distribution","full_name":"dmp42/distribution","owner":{"login":"dmp42","id":332946,"avatar_url":"https://avatars.githubusercontent.com/u/332946?v=3","gravatar_id":"","url":"https://api.github.com/users/dmp42","html_url":"https://github.com/dmp42","followers_url":"https://api.github.com/users/dmp42/followers","following_url":"https://api.github.com/users/dmp42/following{/other_user}","gists_url":"https://api.github.com/users/dmp42/gists{/gist_id}","starred_url":"https://api.github.com/users/dmp42/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dmp42/subscriptions","organizations_url":"https://api.github.com/users/dmp42/orgs","repos_url":"https://api.github.com/users/dmp42/repos","events_url":"https://api.github.com/users/dmp42/events{/privacy}","received_events_url":"https://api.github.com/users/dmp42/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/dmp42/distribution","description":"The Docker toolset to pack, ship, store, and deliver content","fork":true,"url":"https://api.github.com/repos/dmp42/distribution","forks_url":"https://api.github.com/repos/dmp42/distribution/forks","keys_url":"https://api.github.com/repos/dmp42/distribution/keys{/key_id}","collaborators_url":"https://api.github.com/repos/dmp42/distribution/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/dmp42/distribution/teams","hooks_url":"https://api.github.com/repos/dmp42/distribution/hooks","issue_events_url":"https://api.github.com/repos/dmp42/distribution/issues/events{/number}","events_url":"https://api.github.com/repos/dmp42/distribution/events","assignees_url":"https://api.github.com/repos/dmp42/distribution/assignees{/user}","branches_url":"https://api.github.com/repos/dmp42/distribution/branches{/branch}","tags_url":"https://api.github.com/repos/dmp42/distribution/tags","blobs_url":"https://api.github.com/repos/dmp42/distribution/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/dmp42/distribution/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/dmp42/distribution/git/refs{/sha}","trees_url":"https://api.github.com/repos/dmp42/distribution/git/trees{/sha}","statuses_url":"https://api.github.com/repos/dmp42/distribution/statuses/{sha}","languages_url":"https://api.github.com/repos/dmp42/distribution/languages","stargazers_url":"https://api.github.com/repos/dmp42/distribution/stargazers","contributors_url":"https://api.github.com/repos/dmp42/distribution/contributors","subscribers_url":"https://api.github.com/repos/dmp42/distribution/subscribers","subscription_url":"https://api.github.com/repos/dmp42/distribution/subscription","commits_url":"https://api.github.com/repos/dmp42/distribution/commits{/sha}","git_commits_url":"https://api.github.com/repos/dmp42/distribution/git/commits{/sha}","comments_url":"https://api.github.com/repos/dmp42/distribution/comments{/number}","issue_comment_url":"https://api.github.com/repos/dmp42/distribution/issues/comments{/number}","contents_url":"https://api.github.com/repos/dmp42/distribution/contents/{+path}","compare_url":"https://api.github.com/repos/dmp42/distribution/compare/{base}...{head}","merges_url":"https://api.github.com/repos/dmp42/distribution/merges","archive_url":"https://api.github.com/repos/dmp42/distribution/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/dmp42/distribution/downloads","issues_url":"https://api.github.com/repos/dmp42/distribution/issues{/number}","pulls_url":"https://api.github.com/repos/dmp42/distribution/pulls{/number}","milestones_url":"https://api.github.com/repos/dmp42/distribution/milestones{/number}","notifications_url":"https://api.github.com/repos/dmp42/distribution/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/dmp42/distribution/labels{/name}","releases_url":"https://api.github.com/repos/dmp42/distribution/releases{/id}","created_at":"2015-05-19T16:46:43Z","updated_at":"2015-05-19T16:46:44Z","pushed_at":"2015-05-21T22:01:16Z","git_url":"git://github.com/dmp42/distribution.git","ssh_url":"git@github.com:dmp42/distribution.git","clone_url":"https://github.com/dmp42/distribution.git","svn_url":"https://github.com/dmp42/distribution","homepage":null,"size":2260,"stargazers_count":0,"watchers_count":0,"language":"Go","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":"docker:master","ref":"master","sha":"2317f721a3d8428215a2b65da4ae85212ed473b4","user":{"login":"docker","id":5429470,"avatar_url":"https://avatars.githubusercontent.com/u/5429470?v=3","gravatar_id":"","url":"https://api.github.com/users/docker","html_url":"https://github.com/docker","followers_url":"https://api.github.com/users/docker/followers","following_url":"https://api.github.com/users/docker/following{/other_user}","gists_url":"https://api.github.com/users/docker/gists{/gist_id}","starred_url":"https://api.github.com/users/docker/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/docker/subscriptions","organizations_url":"https://api.github.com/users/docker/orgs","repos_url":"https://api.github.com/users/docker/repos","events_url":"https://api.github.com/users/docker/events{/privacy}","received_events_url":"https://api.github.com/users/docker/received_events","type":"Organization","site_admin":false},"repo":{"id":28366058,"name":"distribution","full_name":"docker/distribution","owner":{"login":"docker","id":5429470,"avatar_url":"https://avatars.githubusercontent.com/u/5429470?v=3","gravatar_id":"","url":"https://api.github.com/users/docker","html_url":"https://github.com/docker","followers_url":"https://api.github.com/users/docker/followers","following_url":"https://api.github.com/users/docker/following{/other_user}","gists_url":"https://api.github.com/users/docker/gists{/gist_id}","starred_url":"https://api.github.com/users/docker/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/docker/subscriptions","organizations_url":"https://api.github.com/users/docker/orgs","repos_url":"https://api.github.com/users/docker/repos","events_url":"https://api.github.com/users/docker/events{/privacy}","received_events_url":"https://api.github.com/users/docker/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/docker/distribution","description":"The Docker toolset to pack, ship, store, and deliver content","fork":false,"url":"https://api.github.com/repos/docker/distribution","forks_url":"https://api.github.com/repos/docker/distribution/forks","keys_url":"https://api.github.com/repos/docker/distribution/keys{/key_id}","collaborators_url":"https://api.github.com/repos/docker/distribution/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/docker/distribution/teams","hooks_url":"https://api.github.com/repos/docker/distribution/hooks","issue_events_url":"https://api.github.com/repos/docker/distribution/issues/events{/number}","events_url":"https://api.github.com/repos/docker/distribution/events","assignees_url":"https://api.github.com/repos/docker/distribution/assignees{/user}","branches_url":"https://api.github.com/repos/docker/distribution/branches{/branch}","tags_url":"https://api.github.com/repos/docker/distribution/tags","blobs_url":"https://api.github.com/repos/docker/distribution/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/docker/distribution/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/docker/distribution/git/refs{/sha}","trees_url":"https://api.github.com/repos/docker/distribution/git/trees{/sha}","statuses_url":"https://api.github.com/repos/docker/distribution/statuses/{sha}","languages_url":"https://api.github.com/repos/docker/distribution/languages","stargazers_url":"https://api.github.com/repos/docker/distribution/stargazers","contributors_url":"https://api.github.com/repos/docker/distribution/contributors","subscribers_url":"https://api.github.com/repos/docker/distribution/subscribers","subscription_url":"https://api.github.com/repos/docker/distribution/subscription","commits_url":"https://api.github.com/repos/docker/distribution/commits{/sha}","git_commits_url":"https://api.github.com/repos/docker/distribution/git/commits{/sha}","comments_url":"https://api.github.com/repos/docker/distribution/comments{/number}","issue_comment_url":"https://api.github.com/repos/docker/distribution/issues/comments{/number}","contents_url":"https://api.github.com/repos/docker/distribution/contents/{+path}","compare_url":"https://api.github.com/repos/docker/distribution/compare/{base}...{head}","merges_url":"https://api.github.com/repos/docker/distribution/merges","archive_url":"https://api.github.com/repos/docker/distribution/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/docker/distribution/downloads","issues_url":"https://api.github.com/repos/docker/distribution/issues{/number}","pulls_url":"https://api.github.com/repos/docker/distribution/pulls{/number}","milestones_url":"https://api.github.com/repos/docker/distribution/milestones{/number}","notifications_url":"https://api.github.com/repos/docker/distribution/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/docker/distribution/labels{/name}","releases_url":"https://api.github.com/repos/docker/distribution/releases{/id}","created_at":"2014-12-22T23:49:26Z","updated_at":"2015-05-21T17:05:35Z","pushed_at":"2015-05-21T22:01:17Z","git_url":"git://github.com/docker/distribution.git","ssh_url":"git@github.com:docker/distribution.git","clone_url":"https://github.com/docker/distribution.git","svn_url":"https://github.com/docker/distribution","homepage":null,"size":8758,"stargazers_count":499,"watchers_count":499,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":176,"mirror_url":null,"open_issues_count":129,"forks":176,"open_issues":129,"watchers":499,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/docker/distribution/pulls/545"},"html":{"href":"https://github.com/docker/distribution/pull/545"},"issue":{"href":"https://api.github.com/repos/docker/distribution/issues/545"},"comments":{"href":"https://api.github.com/repos/docker/distribution/issues/545/comments"},"review_comments":{"href":"https://api.github.com/repos/docker/distribution/pulls/545/comments"},"review_comment":{"href":"https://api.github.com/repos/docker/distribution/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/docker/distribution/pulls/545/commits"},"statuses":{"href":"https://api.github.com/repos/docker/distribution/statuses/c3c888db5a55c94cbaec70737c5178f0a402b5ea"}}}}