{"action":"created","comment":{"url":"https://api.github.com/repos/Shopify/css/pulls/comments/91769391","pull_request_review_id":12281818,"id":91769391,"diff_hunk":"@@ -44,27 +45,70 @@ Block comments should be used to create meaningful divisions in your file. Each\n   color: red;\n }\n \n+// Bad!\n+//\n+// You should use three slashes instead of two for block comments\n+\n+//\n+// This is a bad block comment\n+\n+.red-bull {\n+  content: 'bull';\n+  color: red;\n+}\n+\n \n // Good!\n \n+///\n+/// This is a good block comment\n+\n+.red-bull {\n+  content: 'bull';\n+  color: red;\n+}\n+```\n+\n+## File comments\n+File comments (or poster comments as they are referred to in SassDoc) should be used to label an overall file. Each file comment should be preceded and followed by a line with `////`. It is also a good idea to add a `@group` to help structure our SassDocs\n+\n+```scss\n+// Bad!\n //\n-// This is a good block comment\n+// You shouldn't mix characters for signifying block comments\n+\n+/*\n+ This is a bad file comment\n+*/\n+.red-bull {\n+  content: 'bull';\n+  color: red;\n+}\n+\n+\n+// Good!\n+\n+////","path":"commenting/readme.md","position":67,"original_position":67,"commit_id":"8722dd0264f9934c3b2ba1e7104c8b938c655143","original_commit_id":"8722dd0264f9934c3b2ba1e7104c8b938c655143","user":{"login":"beefchimi","id":643944,"avatar_url":"https://avatars.githubusercontent.com/u/643944?v=3","gravatar_id":"","url":"https://api.github.com/users/beefchimi","html_url":"https://github.com/beefchimi","followers_url":"https://api.github.com/users/beefchimi/followers","following_url":"https://api.github.com/users/beefchimi/following{/other_user}","gists_url":"https://api.github.com/users/beefchimi/gists{/gist_id}","starred_url":"https://api.github.com/users/beefchimi/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/beefchimi/subscriptions","organizations_url":"https://api.github.com/users/beefchimi/orgs","repos_url":"https://api.github.com/users/beefchimi/repos","events_url":"https://api.github.com/users/beefchimi/events{/privacy}","received_events_url":"https://api.github.com/users/beefchimi/received_events","type":"User","site_admin":false},"body":"lol never mind maybe I should actually read the content.","created_at":"2016-12-09T18:34:19Z","updated_at":"2016-12-09T18:34:19Z","html_url":"https://github.com/Shopify/css/pull/14#discussion_r91769391","pull_request_url":"https://api.github.com/repos/Shopify/css/pulls/14","_links":{"self":{"href":"https://api.github.com/repos/Shopify/css/pulls/comments/91769391"},"html":{"href":"https://github.com/Shopify/css/pull/14#discussion_r91769391"},"pull_request":{"href":"https://api.github.com/repos/Shopify/css/pulls/14"}}},"pull_request":{"url":"https://api.github.com/repos/Shopify/css/pulls/14","id":97351881,"html_url":"https://github.com/Shopify/css/pull/14","diff_url":"https://github.com/Shopify/css/pull/14.diff","patch_url":"https://github.com/Shopify/css/pull/14.patch","issue_url":"https://api.github.com/repos/Shopify/css/issues/14","number":14,"state":"open","locked":false,"title":"Commenting updates","user":{"login":"dfmcphee","id":478990,"avatar_url":"https://avatars.githubusercontent.com/u/478990?v=3","gravatar_id":"","url":"https://api.github.com/users/dfmcphee","html_url":"https://github.com/dfmcphee","followers_url":"https://api.github.com/users/dfmcphee/followers","following_url":"https://api.github.com/users/dfmcphee/following{/other_user}","gists_url":"https://api.github.com/users/dfmcphee/gists{/gist_id}","starred_url":"https://api.github.com/users/dfmcphee/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dfmcphee/subscriptions","organizations_url":"https://api.github.com/users/dfmcphee/orgs","repos_url":"https://api.github.com/users/dfmcphee/repos","events_url":"https://api.github.com/users/dfmcphee/events{/privacy}","received_events_url":"https://api.github.com/users/dfmcphee/received_events","type":"User","site_admin":false},"body":"This updates our commenting standard to be compliant with [SassDoc](https://github.com/SassDoc/sassdoc).\r\n\r\nThis means using `///` instead of `//` where we want SassDoc to pick it up. It also adds file level comment blocks.\r\n\r\n@ry5n @beefchimi for review\r\n\r\ncc @Shopify/css ","created_at":"2016-12-09T17:52:25Z","updated_at":"2016-12-09T18:34:19Z","closed_at":null,"merged_at":null,"merge_commit_sha":"e2d642ec8bbb971022f439a3fcb79c71a334692c","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/Shopify/css/pulls/14/commits","review_comments_url":"https://api.github.com/repos/Shopify/css/pulls/14/comments","review_comment_url":"https://api.github.com/repos/Shopify/css/pulls/comments{/number}","comments_url":"https://api.github.com/repos/Shopify/css/issues/14/comments","statuses_url":"https://api.github.com/repos/Shopify/css/statuses/8722dd0264f9934c3b2ba1e7104c8b938c655143","head":{"label":"Shopify:commenting-updates","ref":"commenting-updates","sha":"8722dd0264f9934c3b2ba1e7104c8b938c655143","user":{"login":"Shopify","id":8085,"avatar_url":"https://avatars.githubusercontent.com/u/8085?v=3","gravatar_id":"","url":"https://api.github.com/users/Shopify","html_url":"https://github.com/Shopify","followers_url":"https://api.github.com/users/Shopify/followers","following_url":"https://api.github.com/users/Shopify/following{/other_user}","gists_url":"https://api.github.com/users/Shopify/gists{/gist_id}","starred_url":"https://api.github.com/users/Shopify/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Shopify/subscriptions","organizations_url":"https://api.github.com/users/Shopify/orgs","repos_url":"https://api.github.com/users/Shopify/repos","events_url":"https://api.github.com/users/Shopify/events{/privacy}","received_events_url":"https://api.github.com/users/Shopify/received_events","type":"Organization","site_admin":false},"repo":{"id":51276264,"name":"css","full_name":"Shopify/css","owner":{"login":"Shopify","id":8085,"avatar_url":"https://avatars.githubusercontent.com/u/8085?v=3","gravatar_id":"","url":"https://api.github.com/users/Shopify","html_url":"https://github.com/Shopify","followers_url":"https://api.github.com/users/Shopify/followers","following_url":"https://api.github.com/users/Shopify/following{/other_user}","gists_url":"https://api.github.com/users/Shopify/gists{/gist_id}","starred_url":"https://api.github.com/users/Shopify/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Shopify/subscriptions","organizations_url":"https://api.github.com/users/Shopify/orgs","repos_url":"https://api.github.com/users/Shopify/repos","events_url":"https://api.github.com/users/Shopify/events{/privacy}","received_events_url":"https://api.github.com/users/Shopify/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/Shopify/css","description":"Guidelines for writing CSS and SCSS at Shopify.","fork":false,"url":"https://api.github.com/repos/Shopify/css","forks_url":"https://api.github.com/repos/Shopify/css/forks","keys_url":"https://api.github.com/repos/Shopify/css/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Shopify/css/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Shopify/css/teams","hooks_url":"https://api.github.com/repos/Shopify/css/hooks","issue_events_url":"https://api.github.com/repos/Shopify/css/issues/events{/number}","events_url":"https://api.github.com/repos/Shopify/css/events","assignees_url":"https://api.github.com/repos/Shopify/css/assignees{/user}","branches_url":"https://api.github.com/repos/Shopify/css/branches{/branch}","tags_url":"https://api.github.com/repos/Shopify/css/tags","blobs_url":"https://api.github.com/repos/Shopify/css/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Shopify/css/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Shopify/css/git/refs{/sha}","trees_url":"https://api.github.com/repos/Shopify/css/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Shopify/css/statuses/{sha}","languages_url":"https://api.github.com/repos/Shopify/css/languages","stargazers_url":"https://api.github.com/repos/Shopify/css/stargazers","contributors_url":"https://api.github.com/repos/Shopify/css/contributors","subscribers_url":"https://api.github.com/repos/Shopify/css/subscribers","subscription_url":"https://api.github.com/repos/Shopify/css/subscription","commits_url":"https://api.github.com/repos/Shopify/css/commits{/sha}","git_commits_url":"https://api.github.com/repos/Shopify/css/git/commits{/sha}","comments_url":"https://api.github.com/repos/Shopify/css/comments{/number}","issue_comment_url":"https://api.github.com/repos/Shopify/css/issues/comments{/number}","contents_url":"https://api.github.com/repos/Shopify/css/contents/{+path}","compare_url":"https://api.github.com/repos/Shopify/css/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Shopify/css/merges","archive_url":"https://api.github.com/repos/Shopify/css/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Shopify/css/downloads","issues_url":"https://api.github.com/repos/Shopify/css/issues{/number}","pulls_url":"https://api.github.com/repos/Shopify/css/pulls{/number}","milestones_url":"https://api.github.com/repos/Shopify/css/milestones{/number}","notifications_url":"https://api.github.com/repos/Shopify/css/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Shopify/css/labels{/name}","releases_url":"https://api.github.com/repos/Shopify/css/releases{/id}","deployments_url":"https://api.github.com/repos/Shopify/css/deployments","created_at":"2016-02-08T02:36:55Z","updated_at":"2016-10-31T21:09:14Z","pushed_at":"2016-12-09T17:52:26Z","git_url":"git://github.com/Shopify/css.git","ssh_url":"git@github.com:Shopify/css.git","clone_url":"https://github.com/Shopify/css.git","svn_url":"https://github.com/Shopify/css","homepage":"","size":41,"stargazers_count":1,"watchers_count":1,"language":"Ruby","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":6,"forks":0,"open_issues":6,"watchers":1,"default_branch":"master"}},"base":{"label":"Shopify:master","ref":"master","sha":"ce7201fffb61404022ad95c2a90b6ba2f61addf1","user":{"login":"Shopify","id":8085,"avatar_url":"https://avatars.githubusercontent.com/u/8085?v=3","gravatar_id":"","url":"https://api.github.com/users/Shopify","html_url":"https://github.com/Shopify","followers_url":"https://api.github.com/users/Shopify/followers","following_url":"https://api.github.com/users/Shopify/following{/other_user}","gists_url":"https://api.github.com/users/Shopify/gists{/gist_id}","starred_url":"https://api.github.com/users/Shopify/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Shopify/subscriptions","organizations_url":"https://api.github.com/users/Shopify/orgs","repos_url":"https://api.github.com/users/Shopify/repos","events_url":"https://api.github.com/users/Shopify/events{/privacy}","received_events_url":"https://api.github.com/users/Shopify/received_events","type":"Organization","site_admin":false},"repo":{"id":51276264,"name":"css","full_name":"Shopify/css","owner":{"login":"Shopify","id":8085,"avatar_url":"https://avatars.githubusercontent.com/u/8085?v=3","gravatar_id":"","url":"https://api.github.com/users/Shopify","html_url":"https://github.com/Shopify","followers_url":"https://api.github.com/users/Shopify/followers","following_url":"https://api.github.com/users/Shopify/following{/other_user}","gists_url":"https://api.github.com/users/Shopify/gists{/gist_id}","starred_url":"https://api.github.com/users/Shopify/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Shopify/subscriptions","organizations_url":"https://api.github.com/users/Shopify/orgs","repos_url":"https://api.github.com/users/Shopify/repos","events_url":"https://api.github.com/users/Shopify/events{/privacy}","received_events_url":"https://api.github.com/users/Shopify/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/Shopify/css","description":"Guidelines for writing CSS and SCSS at Shopify.","fork":false,"url":"https://api.github.com/repos/Shopify/css","forks_url":"https://api.github.com/repos/Shopify/css/forks","keys_url":"https://api.github.com/repos/Shopify/css/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Shopify/css/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Shopify/css/teams","hooks_url":"https://api.github.com/repos/Shopify/css/hooks","issue_events_url":"https://api.github.com/repos/Shopify/css/issues/events{/number}","events_url":"https://api.github.com/repos/Shopify/css/events","assignees_url":"https://api.github.com/repos/Shopify/css/assignees{/user}","branches_url":"https://api.github.com/repos/Shopify/css/branches{/branch}","tags_url":"https://api.github.com/repos/Shopify/css/tags","blobs_url":"https://api.github.com/repos/Shopify/css/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Shopify/css/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Shopify/css/git/refs{/sha}","trees_url":"https://api.github.com/repos/Shopify/css/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Shopify/css/statuses/{sha}","languages_url":"https://api.github.com/repos/Shopify/css/languages","stargazers_url":"https://api.github.com/repos/Shopify/css/stargazers","contributors_url":"https://api.github.com/repos/Shopify/css/contributors","subscribers_url":"https://api.github.com/repos/Shopify/css/subscribers","subscription_url":"https://api.github.com/repos/Shopify/css/subscription","commits_url":"https://api.github.com/repos/Shopify/css/commits{/sha}","git_commits_url":"https://api.github.com/repos/Shopify/css/git/commits{/sha}","comments_url":"https://api.github.com/repos/Shopify/css/comments{/number}","issue_comment_url":"https://api.github.com/repos/Shopify/css/issues/comments{/number}","contents_url":"https://api.github.com/repos/Shopify/css/contents/{+path}","compare_url":"https://api.github.com/repos/Shopify/css/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Shopify/css/merges","archive_url":"https://api.github.com/repos/Shopify/css/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Shopify/css/downloads","issues_url":"https://api.github.com/repos/Shopify/css/issues{/number}","pulls_url":"https://api.github.com/repos/Shopify/css/pulls{/number}","milestones_url":"https://api.github.com/repos/Shopify/css/milestones{/number}","notifications_url":"https://api.github.com/repos/Shopify/css/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Shopify/css/labels{/name}","releases_url":"https://api.github.com/repos/Shopify/css/releases{/id}","deployments_url":"https://api.github.com/repos/Shopify/css/deployments","created_at":"2016-02-08T02:36:55Z","updated_at":"2016-10-31T21:09:14Z","pushed_at":"2016-12-09T17:52:26Z","git_url":"git://github.com/Shopify/css.git","ssh_url":"git@github.com:Shopify/css.git","clone_url":"https://github.com/Shopify/css.git","svn_url":"https://github.com/Shopify/css","homepage":"","size":41,"stargazers_count":1,"watchers_count":1,"language":"Ruby","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":6,"forks":0,"open_issues":6,"watchers":1,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/Shopify/css/pulls/14"},"html":{"href":"https://github.com/Shopify/css/pull/14"},"issue":{"href":"https://api.github.com/repos/Shopify/css/issues/14"},"comments":{"href":"https://api.github.com/repos/Shopify/css/issues/14/comments"},"review_comments":{"href":"https://api.github.com/repos/Shopify/css/pulls/14/comments"},"review_comment":{"href":"https://api.github.com/repos/Shopify/css/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/Shopify/css/pulls/14/commits"},"statuses":{"href":"https://api.github.com/repos/Shopify/css/statuses/8722dd0264f9934c3b2ba1e7104c8b938c655143"}}}}
{"actor":{"display_login":"beefchimi"}}