{"action":"created","comment":{"url":"https://api.github.com/repos/stylelint/stylelint/pulls/comments/29848969","id":29848969,"diff_hunk":"@@ -0,0 +1,52 @@\n+# Naming rules\n+\n+Rules are:\n+\n+* Made of lowercase words separated by hyphens.\n+* Split into two parts:\n+  * The first describes [what thing](http://apps.workflower.fi/vocabs/css/en) the rule applies to.\n+  * The second describes what the rule is enforcing.\n+\n+```js\n+selector-max-specificity\n+   ^           ^\n+   |           |\n+the thing    what the rule is enforcing\n+```\n+\n+## No\n+\n+Most rules *enforce the inclusion or exclusion* of something.\n+\n+For example, whether there should or shouldn't be a trailing semicolon at the end of a declaration block:\n+\n+* `declaration-block-trailing-semicolon`: `bool`\n+  * `true` - there *must* be a trailing semicolon\n+  * `false` - there *must not* be a trailing semicolon\n+\n+If the rule is *disallowing* something use `*-no-*`.\n+\n+For example, whether empty rule-sets should be disallowed or not:\n+\n+* `rule-set-no-empty`: `bool` \n+  * `true`: rule-sets *must not* be empty\n+  * `false`: rule-sets *can* be empty (equivalent to not turning the rule on)\n+\n+In this case it doesn't make sense to enforce that every rule-set *must* be empty.\n+\n+## Max\n+\n+If the rule is *setting a limit* to something use `*-max-*`.\n+\n+For example, specifying the maximum number of digits after the \".\" in a number\n+\n+* `number-max-precision`: `int` \n+\n+## Before and after\n+\n+If the rule is *specifying what whitespace is allowed* around something then use `*-before/after` and use `coma`, `colon`, `semicolon`, `opening-brace`, `closing-brace`, `opening-parenthesis`, `closing-parenthesis`, `operator` and `range-operator` to identify that something.","path":"docs/naming-rules.md","position":47,"original_position":47,"commit_id":"ea1a420403b514ba3251f0bf2be8c61e2ba559a0","original_commit_id":"ea1a420403b514ba3251f0bf2be8c61e2ba559a0","user":{"login":"davidtheclark","id":628431,"avatar_url":"https://avatars.githubusercontent.com/u/628431?v=3","gravatar_id":"","url":"https://api.github.com/users/davidtheclark","html_url":"https://github.com/davidtheclark","followers_url":"https://api.github.com/users/davidtheclark/followers","following_url":"https://api.github.com/users/davidtheclark/following{/other_user}","gists_url":"https://api.github.com/users/davidtheclark/gists{/gist_id}","starred_url":"https://api.github.com/users/davidtheclark/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/davidtheclark/subscriptions","organizations_url":"https://api.github.com/users/davidtheclark/orgs","repos_url":"https://api.github.com/users/davidtheclark/repos","events_url":"https://api.github.com/users/davidtheclark/events{/privacy}","received_events_url":"https://api.github.com/users/davidtheclark/received_events","type":"User","site_admin":false},"body":"Two m's in comma :)","created_at":"2015-05-07T13:01:45Z","updated_at":"2015-05-07T13:01:45Z","html_url":"https://github.com/stylelint/stylelint/pull/13#discussion_r29848969","pull_request_url":"https://api.github.com/repos/stylelint/stylelint/pulls/13","_links":{"self":{"href":"https://api.github.com/repos/stylelint/stylelint/pulls/comments/29848969"},"html":{"href":"https://github.com/stylelint/stylelint/pull/13#discussion_r29848969"},"pull_request":{"href":"https://api.github.com/repos/stylelint/stylelint/pulls/13"}}},"pull_request":{"url":"https://api.github.com/repos/stylelint/stylelint/pulls/13","id":34911344,"html_url":"https://github.com/stylelint/stylelint/pull/13","diff_url":"https://github.com/stylelint/stylelint/pull/13.diff","patch_url":"https://github.com/stylelint/stylelint/pull/13.patch","issue_url":"https://api.github.com/repos/stylelint/stylelint/issues/13","number":13,"state":"open","locked":false,"title":"Add naming rules doc","user":{"login":"jeddy3","id":808227,"avatar_url":"https://avatars.githubusercontent.com/u/808227?v=3","gravatar_id":"","url":"https://api.github.com/users/jeddy3","html_url":"https://github.com/jeddy3","followers_url":"https://api.github.com/users/jeddy3/followers","following_url":"https://api.github.com/users/jeddy3/following{/other_user}","gists_url":"https://api.github.com/users/jeddy3/gists{/gist_id}","starred_url":"https://api.github.com/users/jeddy3/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jeddy3/subscriptions","organizations_url":"https://api.github.com/users/jeddy3/orgs","repos_url":"https://api.github.com/users/jeddy3/repos","events_url":"https://api.github.com/users/jeddy3/events{/privacy}","received_events_url":"https://api.github.com/users/jeddy3/received_events","type":"User","site_admin":false},"body":"Ha, this was harder than I thought! :)\r\n\r\nI'm not happy with how I've described the difference between \"normal\" rules and `*-no-*` rules. Any ideas?","created_at":"2015-05-07T12:43:42Z","updated_at":"2015-05-07T13:01:45Z","closed_at":null,"merged_at":null,"merge_commit_sha":"9855db209ebbcb441346fa34ce33c1aad059e50b","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/stylelint/stylelint/pulls/13/commits","review_comments_url":"https://api.github.com/repos/stylelint/stylelint/pulls/13/comments","review_comment_url":"https://api.github.com/repos/stylelint/stylelint/pulls/comments{/number}","comments_url":"https://api.github.com/repos/stylelint/stylelint/issues/13/comments","statuses_url":"https://api.github.com/repos/stylelint/stylelint/statuses/ea1a420403b514ba3251f0bf2be8c61e2ba559a0","head":{"label":"jeddy3:naming-rules","ref":"naming-rules","sha":"ea1a420403b514ba3251f0bf2be8c61e2ba559a0","user":{"login":"jeddy3","id":808227,"avatar_url":"https://avatars.githubusercontent.com/u/808227?v=3","gravatar_id":"","url":"https://api.github.com/users/jeddy3","html_url":"https://github.com/jeddy3","followers_url":"https://api.github.com/users/jeddy3/followers","following_url":"https://api.github.com/users/jeddy3/following{/other_user}","gists_url":"https://api.github.com/users/jeddy3/gists{/gist_id}","starred_url":"https://api.github.com/users/jeddy3/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jeddy3/subscriptions","organizations_url":"https://api.github.com/users/jeddy3/orgs","repos_url":"https://api.github.com/users/jeddy3/repos","events_url":"https://api.github.com/users/jeddy3/events{/privacy}","received_events_url":"https://api.github.com/users/jeddy3/received_events","type":"User","site_admin":false},"repo":{"id":35169293,"name":"stylelint","full_name":"jeddy3/stylelint","owner":{"login":"jeddy3","id":808227,"avatar_url":"https://avatars.githubusercontent.com/u/808227?v=3","gravatar_id":"","url":"https://api.github.com/users/jeddy3","html_url":"https://github.com/jeddy3","followers_url":"https://api.github.com/users/jeddy3/followers","following_url":"https://api.github.com/users/jeddy3/following{/other_user}","gists_url":"https://api.github.com/users/jeddy3/gists{/gist_id}","starred_url":"https://api.github.com/users/jeddy3/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jeddy3/subscriptions","organizations_url":"https://api.github.com/users/jeddy3/orgs","repos_url":"https://api.github.com/users/jeddy3/repos","events_url":"https://api.github.com/users/jeddy3/events{/privacy}","received_events_url":"https://api.github.com/users/jeddy3/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/jeddy3/stylelint","description":"Modern CSS linter.","fork":true,"url":"https://api.github.com/repos/jeddy3/stylelint","forks_url":"https://api.github.com/repos/jeddy3/stylelint/forks","keys_url":"https://api.github.com/repos/jeddy3/stylelint/keys{/key_id}","collaborators_url":"https://api.github.com/repos/jeddy3/stylelint/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/jeddy3/stylelint/teams","hooks_url":"https://api.github.com/repos/jeddy3/stylelint/hooks","issue_events_url":"https://api.github.com/repos/jeddy3/stylelint/issues/events{/number}","events_url":"https://api.github.com/repos/jeddy3/stylelint/events","assignees_url":"https://api.github.com/repos/jeddy3/stylelint/assignees{/user}","branches_url":"https://api.github.com/repos/jeddy3/stylelint/branches{/branch}","tags_url":"https://api.github.com/repos/jeddy3/stylelint/tags","blobs_url":"https://api.github.com/repos/jeddy3/stylelint/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/jeddy3/stylelint/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/jeddy3/stylelint/git/refs{/sha}","trees_url":"https://api.github.com/repos/jeddy3/stylelint/git/trees{/sha}","statuses_url":"https://api.github.com/repos/jeddy3/stylelint/statuses/{sha}","languages_url":"https://api.github.com/repos/jeddy3/stylelint/languages","stargazers_url":"https://api.github.com/repos/jeddy3/stylelint/stargazers","contributors_url":"https://api.github.com/repos/jeddy3/stylelint/contributors","subscribers_url":"https://api.github.com/repos/jeddy3/stylelint/subscribers","subscription_url":"https://api.github.com/repos/jeddy3/stylelint/subscription","commits_url":"https://api.github.com/repos/jeddy3/stylelint/commits{/sha}","git_commits_url":"https://api.github.com/repos/jeddy3/stylelint/git/commits{/sha}","comments_url":"https://api.github.com/repos/jeddy3/stylelint/comments{/number}","issue_comment_url":"https://api.github.com/repos/jeddy3/stylelint/issues/comments{/number}","contents_url":"https://api.github.com/repos/jeddy3/stylelint/contents/{+path}","compare_url":"https://api.github.com/repos/jeddy3/stylelint/compare/{base}...{head}","merges_url":"https://api.github.com/repos/jeddy3/stylelint/merges","archive_url":"https://api.github.com/repos/jeddy3/stylelint/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/jeddy3/stylelint/downloads","issues_url":"https://api.github.com/repos/jeddy3/stylelint/issues{/number}","pulls_url":"https://api.github.com/repos/jeddy3/stylelint/pulls{/number}","milestones_url":"https://api.github.com/repos/jeddy3/stylelint/milestones{/number}","notifications_url":"https://api.github.com/repos/jeddy3/stylelint/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/jeddy3/stylelint/labels{/name}","releases_url":"https://api.github.com/repos/jeddy3/stylelint/releases{/id}","created_at":"2015-05-06T16:10:20Z","updated_at":"2015-05-06T16:10:21Z","pushed_at":"2015-05-07T12:41:24Z","git_url":"git://github.com/jeddy3/stylelint.git","ssh_url":"git@github.com:jeddy3/stylelint.git","clone_url":"https://github.com/jeddy3/stylelint.git","svn_url":"https://github.com/jeddy3/stylelint","homepage":"https://stylelint.github.io/","size":100,"stargazers_count":0,"watchers_count":0,"language":"JavaScript","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":"stylelint:master","ref":"master","sha":"a59a66e2f626d87037a40f245b1f10dd900907ab","user":{"login":"stylelint","id":10076935,"avatar_url":"https://avatars.githubusercontent.com/u/10076935?v=3","gravatar_id":"","url":"https://api.github.com/users/stylelint","html_url":"https://github.com/stylelint","followers_url":"https://api.github.com/users/stylelint/followers","following_url":"https://api.github.com/users/stylelint/following{/other_user}","gists_url":"https://api.github.com/users/stylelint/gists{/gist_id}","starred_url":"https://api.github.com/users/stylelint/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/stylelint/subscriptions","organizations_url":"https://api.github.com/users/stylelint/orgs","repos_url":"https://api.github.com/users/stylelint/repos","events_url":"https://api.github.com/users/stylelint/events{/privacy}","received_events_url":"https://api.github.com/users/stylelint/received_events","type":"Organization","site_admin":false},"repo":{"id":27549019,"name":"stylelint","full_name":"stylelint/stylelint","owner":{"login":"stylelint","id":10076935,"avatar_url":"https://avatars.githubusercontent.com/u/10076935?v=3","gravatar_id":"","url":"https://api.github.com/users/stylelint","html_url":"https://github.com/stylelint","followers_url":"https://api.github.com/users/stylelint/followers","following_url":"https://api.github.com/users/stylelint/following{/other_user}","gists_url":"https://api.github.com/users/stylelint/gists{/gist_id}","starred_url":"https://api.github.com/users/stylelint/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/stylelint/subscriptions","organizations_url":"https://api.github.com/users/stylelint/orgs","repos_url":"https://api.github.com/users/stylelint/repos","events_url":"https://api.github.com/users/stylelint/events{/privacy}","received_events_url":"https://api.github.com/users/stylelint/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/stylelint/stylelint","description":"Modern CSS linter.","fork":false,"url":"https://api.github.com/repos/stylelint/stylelint","forks_url":"https://api.github.com/repos/stylelint/stylelint/forks","keys_url":"https://api.github.com/repos/stylelint/stylelint/keys{/key_id}","collaborators_url":"https://api.github.com/repos/stylelint/stylelint/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/stylelint/stylelint/teams","hooks_url":"https://api.github.com/repos/stylelint/stylelint/hooks","issue_events_url":"https://api.github.com/repos/stylelint/stylelint/issues/events{/number}","events_url":"https://api.github.com/repos/stylelint/stylelint/events","assignees_url":"https://api.github.com/repos/stylelint/stylelint/assignees{/user}","branches_url":"https://api.github.com/repos/stylelint/stylelint/branches{/branch}","tags_url":"https://api.github.com/repos/stylelint/stylelint/tags","blobs_url":"https://api.github.com/repos/stylelint/stylelint/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/stylelint/stylelint/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/stylelint/stylelint/git/refs{/sha}","trees_url":"https://api.github.com/repos/stylelint/stylelint/git/trees{/sha}","statuses_url":"https://api.github.com/repos/stylelint/stylelint/statuses/{sha}","languages_url":"https://api.github.com/repos/stylelint/stylelint/languages","stargazers_url":"https://api.github.com/repos/stylelint/stylelint/stargazers","contributors_url":"https://api.github.com/repos/stylelint/stylelint/contributors","subscribers_url":"https://api.github.com/repos/stylelint/stylelint/subscribers","subscription_url":"https://api.github.com/repos/stylelint/stylelint/subscription","commits_url":"https://api.github.com/repos/stylelint/stylelint/commits{/sha}","git_commits_url":"https://api.github.com/repos/stylelint/stylelint/git/commits{/sha}","comments_url":"https://api.github.com/repos/stylelint/stylelint/comments{/number}","issue_comment_url":"https://api.github.com/repos/stylelint/stylelint/issues/comments{/number}","contents_url":"https://api.github.com/repos/stylelint/stylelint/contents/{+path}","compare_url":"https://api.github.com/repos/stylelint/stylelint/compare/{base}...{head}","merges_url":"https://api.github.com/repos/stylelint/stylelint/merges","archive_url":"https://api.github.com/repos/stylelint/stylelint/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/stylelint/stylelint/downloads","issues_url":"https://api.github.com/repos/stylelint/stylelint/issues{/number}","pulls_url":"https://api.github.com/repos/stylelint/stylelint/pulls{/number}","milestones_url":"https://api.github.com/repos/stylelint/stylelint/milestones{/number}","notifications_url":"https://api.github.com/repos/stylelint/stylelint/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/stylelint/stylelint/labels{/name}","releases_url":"https://api.github.com/repos/stylelint/stylelint/releases{/id}","created_at":"2014-12-04T16:25:23Z","updated_at":"2015-05-07T00:52:09Z","pushed_at":"2015-05-07T12:43:42Z","git_url":"git://github.com/stylelint/stylelint.git","ssh_url":"git@github.com:stylelint/stylelint.git","clone_url":"https://github.com/stylelint/stylelint.git","svn_url":"https://github.com/stylelint/stylelint","homepage":"https://stylelint.github.io/","size":100,"stargazers_count":31,"watchers_count":31,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":3,"mirror_url":null,"open_issues_count":9,"forks":3,"open_issues":9,"watchers":31,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/stylelint/stylelint/pulls/13"},"html":{"href":"https://github.com/stylelint/stylelint/pull/13"},"issue":{"href":"https://api.github.com/repos/stylelint/stylelint/issues/13"},"comments":{"href":"https://api.github.com/repos/stylelint/stylelint/issues/13/comments"},"review_comments":{"href":"https://api.github.com/repos/stylelint/stylelint/pulls/13/comments"},"review_comment":{"href":"https://api.github.com/repos/stylelint/stylelint/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/stylelint/stylelint/pulls/13/commits"},"statuses":{"href":"https://api.github.com/repos/stylelint/stylelint/statuses/ea1a420403b514ba3251f0bf2be8c61e2ba559a0"}}}}