{"action":"created","comment":{"url":"https://api.github.com/repos/Homebrew/homebrew/pulls/comments/30747406","id":30747406,"diff_hunk":"@@ -1,4 +1,5 @@\n class Ack < Formula\n+  desc \"A search tool like grep, but optimized for programmers\"\n   homepage \"http://beyondgrep.com/\"","path":"Library/Formula/ack.rb","position":3,"original_position":3,"commit_id":"72d92334891397222afdf313c0a40a326afae462","original_commit_id":"3d8fc3c931821adcc074dc6b9a2903e9248ee27c","user":{"login":"bfontaine","id":1334295,"avatar_url":"https://avatars.githubusercontent.com/u/1334295?v=3","gravatar_id":"","url":"https://api.github.com/users/bfontaine","html_url":"https://github.com/bfontaine","followers_url":"https://api.github.com/users/bfontaine/followers","following_url":"https://api.github.com/users/bfontaine/following{/other_user}","gists_url":"https://api.github.com/users/bfontaine/gists{/gist_id}","starred_url":"https://api.github.com/users/bfontaine/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bfontaine/subscriptions","organizations_url":"https://api.github.com/users/bfontaine/orgs","repos_url":"https://api.github.com/users/bfontaine/repos","events_url":"https://api.github.com/users/bfontaine/events{/privacy}","received_events_url":"https://api.github.com/users/bfontaine/received_events","type":"User","site_admin":false},"body":"I first was in favor of “homepage then desc then the rest” but I read @adzenith’s comment and now agree with the “description first, then homepage, then the rest”. The `desc` is indeed the more relevant here, and the homepage’s URL doesn’t usually give you much information about the software (say the formula is “foobar”, the URL will likely be `foobar.sourceforge.net` or `some-academic-website.edu/~doe/software/foobar`) and you can open it quickly in your browser with `brew home <formula>`.","created_at":"2015-05-20T20:47:26Z","updated_at":"2015-05-20T20:47:26Z","html_url":"https://github.com/Homebrew/homebrew/pull/39911#discussion_r30747406","pull_request_url":"https://api.github.com/repos/Homebrew/homebrew/pulls/39911","_links":{"self":{"href":"https://api.github.com/repos/Homebrew/homebrew/pulls/comments/30747406"},"html":{"href":"https://github.com/Homebrew/homebrew/pull/39911#discussion_r30747406"},"pull_request":{"href":"https://api.github.com/repos/Homebrew/homebrew/pulls/39911"}}},"pull_request":{"url":"https://api.github.com/repos/Homebrew/homebrew/pulls/39911","id":35762614,"html_url":"https://github.com/Homebrew/homebrew/pull/39911","diff_url":"https://github.com/Homebrew/homebrew/pull/39911.diff","patch_url":"https://github.com/Homebrew/homebrew/pull/39911.patch","issue_url":"https://api.github.com/repos/Homebrew/homebrew/issues/39911","number":39911,"state":"open","locked":false,"title":"Add description field to Formulae","user":{"login":"adzenith","id":614934,"avatar_url":"https://avatars.githubusercontent.com/u/614934?v=3","gravatar_id":"","url":"https://api.github.com/users/adzenith","html_url":"https://github.com/adzenith","followers_url":"https://api.github.com/users/adzenith/followers","following_url":"https://api.github.com/users/adzenith/following{/other_user}","gists_url":"https://api.github.com/users/adzenith/gists{/gist_id}","starred_url":"https://api.github.com/users/adzenith/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adzenith/subscriptions","organizations_url":"https://api.github.com/users/adzenith/orgs","repos_url":"https://api.github.com/users/adzenith/repos","events_url":"https://api.github.com/users/adzenith/events{/privacy}","received_events_url":"https://api.github.com/users/adzenith/received_events","type":"User","site_admin":false},"body":"• Add a desc field to the Formula class\r\n• Fill out the desc field for each formula in Homebrew/homebrew\r\n• `brew audit` checks for desc\r\n• `brew info` shows the desc\r\n• `brew search --desc` searches on desc (preliminary)","created_at":"2015-05-19T18:54:16Z","updated_at":"2015-05-20T20:47:26Z","closed_at":null,"merged_at":null,"merge_commit_sha":"47d0d6686838413f4a4848fe347f7136e4dd054e","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/Homebrew/homebrew/pulls/39911/commits","review_comments_url":"https://api.github.com/repos/Homebrew/homebrew/pulls/39911/comments","review_comment_url":"https://api.github.com/repos/Homebrew/homebrew/pulls/comments{/number}","comments_url":"https://api.github.com/repos/Homebrew/homebrew/issues/39911/comments","statuses_url":"https://api.github.com/repos/Homebrew/homebrew/statuses/72d92334891397222afdf313c0a40a326afae462","head":{"label":"adzenith:master","ref":"master","sha":"72d92334891397222afdf313c0a40a326afae462","user":{"login":"adzenith","id":614934,"avatar_url":"https://avatars.githubusercontent.com/u/614934?v=3","gravatar_id":"","url":"https://api.github.com/users/adzenith","html_url":"https://github.com/adzenith","followers_url":"https://api.github.com/users/adzenith/followers","following_url":"https://api.github.com/users/adzenith/following{/other_user}","gists_url":"https://api.github.com/users/adzenith/gists{/gist_id}","starred_url":"https://api.github.com/users/adzenith/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adzenith/subscriptions","organizations_url":"https://api.github.com/users/adzenith/orgs","repos_url":"https://api.github.com/users/adzenith/repos","events_url":"https://api.github.com/users/adzenith/events{/privacy}","received_events_url":"https://api.github.com/users/adzenith/received_events","type":"User","site_admin":false},"repo":{"id":6283861,"name":"homebrew","full_name":"adzenith/homebrew","owner":{"login":"adzenith","id":614934,"avatar_url":"https://avatars.githubusercontent.com/u/614934?v=3","gravatar_id":"","url":"https://api.github.com/users/adzenith","html_url":"https://github.com/adzenith","followers_url":"https://api.github.com/users/adzenith/followers","following_url":"https://api.github.com/users/adzenith/following{/other_user}","gists_url":"https://api.github.com/users/adzenith/gists{/gist_id}","starred_url":"https://api.github.com/users/adzenith/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adzenith/subscriptions","organizations_url":"https://api.github.com/users/adzenith/orgs","repos_url":"https://api.github.com/users/adzenith/repos","events_url":"https://api.github.com/users/adzenith/events{/privacy}","received_events_url":"https://api.github.com/users/adzenith/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/adzenith/homebrew","description":"The missing package manager for OS X.","fork":true,"url":"https://api.github.com/repos/adzenith/homebrew","forks_url":"https://api.github.com/repos/adzenith/homebrew/forks","keys_url":"https://api.github.com/repos/adzenith/homebrew/keys{/key_id}","collaborators_url":"https://api.github.com/repos/adzenith/homebrew/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/adzenith/homebrew/teams","hooks_url":"https://api.github.com/repos/adzenith/homebrew/hooks","issue_events_url":"https://api.github.com/repos/adzenith/homebrew/issues/events{/number}","events_url":"https://api.github.com/repos/adzenith/homebrew/events","assignees_url":"https://api.github.com/repos/adzenith/homebrew/assignees{/user}","branches_url":"https://api.github.com/repos/adzenith/homebrew/branches{/branch}","tags_url":"https://api.github.com/repos/adzenith/homebrew/tags","blobs_url":"https://api.github.com/repos/adzenith/homebrew/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/adzenith/homebrew/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/adzenith/homebrew/git/refs{/sha}","trees_url":"https://api.github.com/repos/adzenith/homebrew/git/trees{/sha}","statuses_url":"https://api.github.com/repos/adzenith/homebrew/statuses/{sha}","languages_url":"https://api.github.com/repos/adzenith/homebrew/languages","stargazers_url":"https://api.github.com/repos/adzenith/homebrew/stargazers","contributors_url":"https://api.github.com/repos/adzenith/homebrew/contributors","subscribers_url":"https://api.github.com/repos/adzenith/homebrew/subscribers","subscription_url":"https://api.github.com/repos/adzenith/homebrew/subscription","commits_url":"https://api.github.com/repos/adzenith/homebrew/commits{/sha}","git_commits_url":"https://api.github.com/repos/adzenith/homebrew/git/commits{/sha}","comments_url":"https://api.github.com/repos/adzenith/homebrew/comments{/number}","issue_comment_url":"https://api.github.com/repos/adzenith/homebrew/issues/comments{/number}","contents_url":"https://api.github.com/repos/adzenith/homebrew/contents/{+path}","compare_url":"https://api.github.com/repos/adzenith/homebrew/compare/{base}...{head}","merges_url":"https://api.github.com/repos/adzenith/homebrew/merges","archive_url":"https://api.github.com/repos/adzenith/homebrew/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/adzenith/homebrew/downloads","issues_url":"https://api.github.com/repos/adzenith/homebrew/issues{/number}","pulls_url":"https://api.github.com/repos/adzenith/homebrew/pulls{/number}","milestones_url":"https://api.github.com/repos/adzenith/homebrew/milestones{/number}","notifications_url":"https://api.github.com/repos/adzenith/homebrew/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/adzenith/homebrew/labels{/name}","releases_url":"https://api.github.com/repos/adzenith/homebrew/releases{/id}","created_at":"2012-10-18T18:53:12Z","updated_at":"2015-04-21T15:31:32Z","pushed_at":"2015-05-20T19:05:48Z","git_url":"git://github.com/adzenith/homebrew.git","ssh_url":"git@github.com:adzenith/homebrew.git","clone_url":"https://github.com/adzenith/homebrew.git","svn_url":"https://github.com/adzenith/homebrew","homepage":"http://mxcl.github.com/homebrew","size":44266,"stargazers_count":0,"watchers_count":0,"language":"Ruby","has_issues":false,"has_downloads":false,"has_wiki":true,"has_pages":false,"forks_count":1,"mirror_url":null,"open_issues_count":0,"forks":1,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"Homebrew:master","ref":"master","sha":"ae8827439e7664d4cad7d66e5c78ea86da21b777","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-05-20T18:23:06Z","pushed_at":"2015-05-20T20:45:36Z","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":1554112,"stargazers_count":23020,"watchers_count":23020,"language":"Ruby","has_issues":true,"has_downloads":false,"has_wiki":true,"has_pages":true,"forks_count":11596,"mirror_url":null,"open_issues_count":394,"forks":11596,"open_issues":394,"watchers":23020,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/Homebrew/homebrew/pulls/39911"},"html":{"href":"https://github.com/Homebrew/homebrew/pull/39911"},"issue":{"href":"https://api.github.com/repos/Homebrew/homebrew/issues/39911"},"comments":{"href":"https://api.github.com/repos/Homebrew/homebrew/issues/39911/comments"},"review_comments":{"href":"https://api.github.com/repos/Homebrew/homebrew/pulls/39911/comments"},"review_comment":{"href":"https://api.github.com/repos/Homebrew/homebrew/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/Homebrew/homebrew/pulls/39911/commits"},"statuses":{"href":"https://api.github.com/repos/Homebrew/homebrew/statuses/72d92334891397222afdf313c0a40a326afae462"}}}}