{"action":"created","comment":{"url":"https://api.github.com/repos/Homebrew/homebrew/pulls/comments/46784326","id":46784326,"diff_hunk":"@@ -588,24 +507,11 @@ class Foo < Formula\n end\n ```\n \n-Formulae that only have `head` versions should be submitted to [homebrew/headonly](https://github.com/Homebrew/homebrew-headonly) instead of Homebrew/homebrew.\n-\n-### devel\n-\n-The \"devel\" spec (activated by passing `--devel`) is used for a project’s unstable releases. It is specified in a block:\n-\n-```ruby\n-devel do\n-  url \"https://foo.com/foo-0.1.tar.gz\"\n-  sha256 \"85cc828a96735bdafcf29eb6291ca91bac846579bcef7308536e0c875d6c81d7\"\n-end\n-```\n-\n-You can test if the \"devel\" spec is in use with `build.devel?`.\n+Formulae that only have [`head`](http://www.rubydoc.info/github/Homebrew/homebrew/master/Formula#head-class_method) versions should be submitted to [homebrew/headonly](https://github.com/Homebrew/homebrew-headonly) instead of Homebrew/homebrew.\n \n ## Compiler selection\n \n-Sometimes a package fails to build when using a certain compiler. Since recent Xcode no longer includes a GCC compiler, we cannot simply force the use of GCC. Instead, the correct way to declare this is the `fails_with` DSL method. A properly constructed `fails_with` block documents the latest compiler build version known to cause compilation to fail, and the cause of the failure. For example:\n+Sometimes a package fails to build when using a certain compiler. Since recent Xcodes no longer include a GCC compiler we cannot simply force the use of GCC. Instead, the correct way to declare this is the [`fails_with` DSL method](http://www.rubydoc.info/github/Homebrew/homebrew/master/Formula#fails_with-class_method). A properly constructed [`fails_with`](http://www.rubydoc.info/github/Homebrew/homebrew/master/Formula#fails_with-class_method) block documents the latest compiler build version known to cause compilation to fail, and the cause of the failure. For example:","path":"share/doc/homebrew/Formula-Cookbook.md","position":null,"original_position":692,"commit_id":"5799fda8a9270b3aacb27a7e73350442683bb081","original_commit_id":"0f7c4ebda151a2352fc272e6d1b9b293613b34f2","user":{"login":"xu-cheng","id":3105373,"avatar_url":"https://avatars.githubusercontent.com/u/3105373?v=3","gravatar_id":"","url":"https://api.github.com/users/xu-cheng","html_url":"https://github.com/xu-cheng","followers_url":"https://api.github.com/users/xu-cheng/followers","following_url":"https://api.github.com/users/xu-cheng/following{/other_user}","gists_url":"https://api.github.com/users/xu-cheng/gists{/gist_id}","starred_url":"https://api.github.com/users/xu-cheng/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/xu-cheng/subscriptions","organizations_url":"https://api.github.com/users/xu-cheng/orgs","repos_url":"https://api.github.com/users/xu-cheng/repos","events_url":"https://api.github.com/users/xu-cheng/events{/privacy}","received_events_url":"https://api.github.com/users/xu-cheng/received_events","type":"User","site_admin":false},"body":"> cause is a no-op\r\n\r\nWe may want to store such information in the future. Beside, I think it's a nice DSL which can encourage/remind authors to document the cause then normal comment(which feels more optional).","created_at":"2015-12-07T03:31:05Z","updated_at":"2015-12-07T03:31:05Z","html_url":"https://github.com/Homebrew/homebrew/pull/46618#discussion_r46784326","pull_request_url":"https://api.github.com/repos/Homebrew/homebrew/pulls/46618","_links":{"self":{"href":"https://api.github.com/repos/Homebrew/homebrew/pulls/comments/46784326"},"html":{"href":"https://github.com/Homebrew/homebrew/pull/46618#discussion_r46784326"},"pull_request":{"href":"https://api.github.com/repos/Homebrew/homebrew/pulls/46618"}}},"pull_request":{"url":"https://api.github.com/repos/Homebrew/homebrew/pulls/46618","id":52521155,"html_url":"https://github.com/Homebrew/homebrew/pull/46618","diff_url":"https://github.com/Homebrew/homebrew/pull/46618.diff","patch_url":"https://github.com/Homebrew/homebrew/pull/46618.patch","issue_url":"https://api.github.com/repos/Homebrew/homebrew/issues/46618","number":46618,"state":"open","locked":false,"title":"Overhaul, simplify and cleanup documentation.","user":{"login":"mikemcquaid","id":125011,"avatar_url":"https://avatars.githubusercontent.com/u/125011?v=3","gravatar_id":"","url":"https://api.github.com/users/mikemcquaid","html_url":"https://github.com/mikemcquaid","followers_url":"https://api.github.com/users/mikemcquaid/followers","following_url":"https://api.github.com/users/mikemcquaid/following{/other_user}","gists_url":"https://api.github.com/users/mikemcquaid/gists{/gist_id}","starred_url":"https://api.github.com/users/mikemcquaid/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mikemcquaid/subscriptions","organizations_url":"https://api.github.com/users/mikemcquaid/orgs","repos_url":"https://api.github.com/users/mikemcquaid/repos","events_url":"https://api.github.com/users/mikemcquaid/events{/privacy}","received_events_url":"https://api.github.com/users/mikemcquaid/received_events","type":"User","site_admin":true},"body":"Remove duplication, link to the API documentation more often, tweak wording, add `@UniqMartin` as a maintainer, note `@jacknagel`'s and `@adamv`'s significant past contributions to Homebrew, delete some outdated or unneeded documentation, add some missing `Formula` API` entries and simplify/improve `CONTRIBUTING.md`.\r\n\r\nCloses #46179.","created_at":"2015-12-03T11:17:20Z","updated_at":"2015-12-07T03:31:05Z","closed_at":null,"merged_at":null,"merge_commit_sha":"e6254483f9a208ee6e65a6ddef635db78c761bbe","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/Homebrew/homebrew/pulls/46618/commits","review_comments_url":"https://api.github.com/repos/Homebrew/homebrew/pulls/46618/comments","review_comment_url":"https://api.github.com/repos/Homebrew/homebrew/pulls/comments{/number}","comments_url":"https://api.github.com/repos/Homebrew/homebrew/issues/46618/comments","statuses_url":"https://api.github.com/repos/Homebrew/homebrew/statuses/5799fda8a9270b3aacb27a7e73350442683bb081","head":{"label":"mikemcquaid:documentation-overhaul","ref":"documentation-overhaul","sha":"5799fda8a9270b3aacb27a7e73350442683bb081","user":{"login":"mikemcquaid","id":125011,"avatar_url":"https://avatars.githubusercontent.com/u/125011?v=3","gravatar_id":"","url":"https://api.github.com/users/mikemcquaid","html_url":"https://github.com/mikemcquaid","followers_url":"https://api.github.com/users/mikemcquaid/followers","following_url":"https://api.github.com/users/mikemcquaid/following{/other_user}","gists_url":"https://api.github.com/users/mikemcquaid/gists{/gist_id}","starred_url":"https://api.github.com/users/mikemcquaid/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mikemcquaid/subscriptions","organizations_url":"https://api.github.com/users/mikemcquaid/orgs","repos_url":"https://api.github.com/users/mikemcquaid/repos","events_url":"https://api.github.com/users/mikemcquaid/events{/privacy}","received_events_url":"https://api.github.com/users/mikemcquaid/received_events","type":"User","site_admin":true},"repo":{"id":346070,"name":"homebrew","full_name":"mikemcquaid/homebrew","owner":{"login":"mikemcquaid","id":125011,"avatar_url":"https://avatars.githubusercontent.com/u/125011?v=3","gravatar_id":"","url":"https://api.github.com/users/mikemcquaid","html_url":"https://github.com/mikemcquaid","followers_url":"https://api.github.com/users/mikemcquaid/followers","following_url":"https://api.github.com/users/mikemcquaid/following{/other_user}","gists_url":"https://api.github.com/users/mikemcquaid/gists{/gist_id}","starred_url":"https://api.github.com/users/mikemcquaid/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mikemcquaid/subscriptions","organizations_url":"https://api.github.com/users/mikemcquaid/orgs","repos_url":"https://api.github.com/users/mikemcquaid/repos","events_url":"https://api.github.com/users/mikemcquaid/events{/privacy}","received_events_url":"https://api.github.com/users/mikemcquaid/received_events","type":"User","site_admin":true},"private":false,"html_url":"https://github.com/mikemcquaid/homebrew","description":"Packaging system for Mac OS X 10.5 and above; heavy optimisations, no redundant packages and a bonus beer theme","fork":true,"url":"https://api.github.com/repos/mikemcquaid/homebrew","forks_url":"https://api.github.com/repos/mikemcquaid/homebrew/forks","keys_url":"https://api.github.com/repos/mikemcquaid/homebrew/keys{/key_id}","collaborators_url":"https://api.github.com/repos/mikemcquaid/homebrew/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/mikemcquaid/homebrew/teams","hooks_url":"https://api.github.com/repos/mikemcquaid/homebrew/hooks","issue_events_url":"https://api.github.com/repos/mikemcquaid/homebrew/issues/events{/number}","events_url":"https://api.github.com/repos/mikemcquaid/homebrew/events","assignees_url":"https://api.github.com/repos/mikemcquaid/homebrew/assignees{/user}","branches_url":"https://api.github.com/repos/mikemcquaid/homebrew/branches{/branch}","tags_url":"https://api.github.com/repos/mikemcquaid/homebrew/tags","blobs_url":"https://api.github.com/repos/mikemcquaid/homebrew/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/mikemcquaid/homebrew/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/mikemcquaid/homebrew/git/refs{/sha}","trees_url":"https://api.github.com/repos/mikemcquaid/homebrew/git/trees{/sha}","statuses_url":"https://api.github.com/repos/mikemcquaid/homebrew/statuses/{sha}","languages_url":"https://api.github.com/repos/mikemcquaid/homebrew/languages","stargazers_url":"https://api.github.com/repos/mikemcquaid/homebrew/stargazers","contributors_url":"https://api.github.com/repos/mikemcquaid/homebrew/contributors","subscribers_url":"https://api.github.com/repos/mikemcquaid/homebrew/subscribers","subscription_url":"https://api.github.com/repos/mikemcquaid/homebrew/subscription","commits_url":"https://api.github.com/repos/mikemcquaid/homebrew/commits{/sha}","git_commits_url":"https://api.github.com/repos/mikemcquaid/homebrew/git/commits{/sha}","comments_url":"https://api.github.com/repos/mikemcquaid/homebrew/comments{/number}","issue_comment_url":"https://api.github.com/repos/mikemcquaid/homebrew/issues/comments{/number}","contents_url":"https://api.github.com/repos/mikemcquaid/homebrew/contents/{+path}","compare_url":"https://api.github.com/repos/mikemcquaid/homebrew/compare/{base}...{head}","merges_url":"https://api.github.com/repos/mikemcquaid/homebrew/merges","archive_url":"https://api.github.com/repos/mikemcquaid/homebrew/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/mikemcquaid/homebrew/downloads","issues_url":"https://api.github.com/repos/mikemcquaid/homebrew/issues{/number}","pulls_url":"https://api.github.com/repos/mikemcquaid/homebrew/pulls{/number}","milestones_url":"https://api.github.com/repos/mikemcquaid/homebrew/milestones{/number}","notifications_url":"https://api.github.com/repos/mikemcquaid/homebrew/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/mikemcquaid/homebrew/labels{/name}","releases_url":"https://api.github.com/repos/mikemcquaid/homebrew/releases{/id}","created_at":"2009-10-22T14:34:12Z","updated_at":"2015-01-15T11:22:52Z","pushed_at":"2015-12-06T22:18:20Z","git_url":"git://github.com/mikemcquaid/homebrew.git","ssh_url":"git@github.com:mikemcquaid/homebrew.git","clone_url":"https://github.com/mikemcquaid/homebrew.git","svn_url":"https://github.com/mikemcquaid/homebrew","homepage":"","size":65078,"stargazers_count":1,"watchers_count":1,"language":"Ruby","has_issues":true,"has_downloads":false,"has_wiki":false,"has_pages":false,"forks_count":1,"mirror_url":null,"open_issues_count":0,"forks":1,"open_issues":0,"watchers":1,"default_branch":"master"}},"base":{"label":"Homebrew:master","ref":"master","sha":"12f42a6761cb29ed3c9715fe2cbccff02bdc448f","user":{"login":"Homebrew","id":1503512,"avatar_url":"https://avatars.githubusercontent.com/u/1503512?v=3","gravatar_id":"","url":"https://api.github.com/users/Homebrew","html_url":"https://github.com/Homebrew","followers_url":"https://api.github.com/users/Homebrew/followers","following_url":"https://api.github.com/users/Homebrew/following{/other_user}","gists_url":"https://api.github.com/users/Homebrew/gists{/gist_id}","starred_url":"https://api.github.com/users/Homebrew/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Homebrew/subscriptions","organizations_url":"https://api.github.com/users/Homebrew/orgs","repos_url":"https://api.github.com/users/Homebrew/repos","events_url":"https://api.github.com/users/Homebrew/events{/privacy}","received_events_url":"https://api.github.com/users/Homebrew/received_events","type":"Organization","site_admin":false},"repo":{"id":206084,"name":"homebrew","full_name":"Homebrew/homebrew","owner":{"login":"Homebrew","id":1503512,"avatar_url":"https://avatars.githubusercontent.com/u/1503512?v=3","gravatar_id":"","url":"https://api.github.com/users/Homebrew","html_url":"https://github.com/Homebrew","followers_url":"https://api.github.com/users/Homebrew/followers","following_url":"https://api.github.com/users/Homebrew/following{/other_user}","gists_url":"https://api.github.com/users/Homebrew/gists{/gist_id}","starred_url":"https://api.github.com/users/Homebrew/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Homebrew/subscriptions","organizations_url":"https://api.github.com/users/Homebrew/orgs","repos_url":"https://api.github.com/users/Homebrew/repos","events_url":"https://api.github.com/users/Homebrew/events{/privacy}","received_events_url":"https://api.github.com/users/Homebrew/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/Homebrew/homebrew","description":":beer: The missing package manager for OS X.","fork":false,"url":"https://api.github.com/repos/Homebrew/homebrew","forks_url":"https://api.github.com/repos/Homebrew/homebrew/forks","keys_url":"https://api.github.com/repos/Homebrew/homebrew/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Homebrew/homebrew/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Homebrew/homebrew/teams","hooks_url":"https://api.github.com/repos/Homebrew/homebrew/hooks","issue_events_url":"https://api.github.com/repos/Homebrew/homebrew/issues/events{/number}","events_url":"https://api.github.com/repos/Homebrew/homebrew/events","assignees_url":"https://api.github.com/repos/Homebrew/homebrew/assignees{/user}","branches_url":"https://api.github.com/repos/Homebrew/homebrew/branches{/branch}","tags_url":"https://api.github.com/repos/Homebrew/homebrew/tags","blobs_url":"https://api.github.com/repos/Homebrew/homebrew/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Homebrew/homebrew/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Homebrew/homebrew/git/refs{/sha}","trees_url":"https://api.github.com/repos/Homebrew/homebrew/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Homebrew/homebrew/statuses/{sha}","languages_url":"https://api.github.com/repos/Homebrew/homebrew/languages","stargazers_url":"https://api.github.com/repos/Homebrew/homebrew/stargazers","contributors_url":"https://api.github.com/repos/Homebrew/homebrew/contributors","subscribers_url":"https://api.github.com/repos/Homebrew/homebrew/subscribers","subscription_url":"https://api.github.com/repos/Homebrew/homebrew/subscription","commits_url":"https://api.github.com/repos/Homebrew/homebrew/commits{/sha}","git_commits_url":"https://api.github.com/repos/Homebrew/homebrew/git/commits{/sha}","comments_url":"https://api.github.com/repos/Homebrew/homebrew/comments{/number}","issue_comment_url":"https://api.github.com/repos/Homebrew/homebrew/issues/comments{/number}","contents_url":"https://api.github.com/repos/Homebrew/homebrew/contents/{+path}","compare_url":"https://api.github.com/repos/Homebrew/homebrew/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Homebrew/homebrew/merges","archive_url":"https://api.github.com/repos/Homebrew/homebrew/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Homebrew/homebrew/downloads","issues_url":"https://api.github.com/repos/Homebrew/homebrew/issues{/number}","pulls_url":"https://api.github.com/repos/Homebrew/homebrew/pulls{/number}","milestones_url":"https://api.github.com/repos/Homebrew/homebrew/milestones{/number}","notifications_url":"https://api.github.com/repos/Homebrew/homebrew/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Homebrew/homebrew/labels{/name}","releases_url":"https://api.github.com/repos/Homebrew/homebrew/releases{/id}","created_at":"2009-05-20T19:38:37Z","updated_at":"2015-12-07T03:17:44Z","pushed_at":"2015-12-07T03:22:51Z","git_url":"git://github.com/Homebrew/homebrew.git","ssh_url":"git@github.com:Homebrew/homebrew.git","clone_url":"https://github.com/Homebrew/homebrew.git","svn_url":"https://github.com/Homebrew/homebrew","homepage":"http://brew.sh","size":1411356,"stargazers_count":27706,"watchers_count":27706,"language":"Ruby","has_issues":true,"has_downloads":false,"has_wiki":false,"has_pages":false,"forks_count":13730,"mirror_url":null,"open_issues_count":531,"forks":13730,"open_issues":531,"watchers":27706,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/Homebrew/homebrew/pulls/46618"},"html":{"href":"https://github.com/Homebrew/homebrew/pull/46618"},"issue":{"href":"https://api.github.com/repos/Homebrew/homebrew/issues/46618"},"comments":{"href":"https://api.github.com/repos/Homebrew/homebrew/issues/46618/comments"},"review_comments":{"href":"https://api.github.com/repos/Homebrew/homebrew/pulls/46618/comments"},"review_comment":{"href":"https://api.github.com/repos/Homebrew/homebrew/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/Homebrew/homebrew/pulls/46618/commits"},"statuses":{"href":"https://api.github.com/repos/Homebrew/homebrew/statuses/5799fda8a9270b3aacb27a7e73350442683bb081"}}}}