{"action":"created","comment":{"url":"https://api.github.com/repos/ramda/ramda/pulls/comments/77553811","id":77553811,"diff_hunk":"@@ -9,9 +9,9 @@ var _curry2 = require('./internal/_curry2');\n  * @since v0.10.0\n  * @category Object\n  * @sig String -> {k: v} -> {k: v}\n- * @param {String} prop the name of the property to dissociate\n- * @param {Object} obj the object to clone\n- * @return {Object} a new object similar to the original but without the specified property\n+ * @param {String} prop The name of the property to dissociate\n+ * @param {Object} obj The object to clone\n+ * @return {Object} A new object equivalent to the original but without the specified property","path":"src/dissoc.js","position":9,"original_position":9,"commit_id":"b69200be730e9f574b3e9b7f07e0c25c466d9528","original_commit_id":"b69200be730e9f574b3e9b7f07e0c25c466d9528","user":{"login":"buzzdecafe","id":716260,"avatar_url":"https://avatars.githubusercontent.com/u/716260?v=3","gravatar_id":"","url":"https://api.github.com/users/buzzdecafe","html_url":"https://github.com/buzzdecafe","followers_url":"https://api.github.com/users/buzzdecafe/followers","following_url":"https://api.github.com/users/buzzdecafe/following{/other_user}","gists_url":"https://api.github.com/users/buzzdecafe/gists{/gist_id}","starred_url":"https://api.github.com/users/buzzdecafe/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/buzzdecafe/subscriptions","organizations_url":"https://api.github.com/users/buzzdecafe/orgs","repos_url":"https://api.github.com/users/buzzdecafe/repos","events_url":"https://api.github.com/users/buzzdecafe/events{/privacy}","received_events_url":"https://api.github.com/users/buzzdecafe/received_events","type":"User","site_admin":false},"body":"as above ","created_at":"2016-09-05T20:11:47Z","updated_at":"2016-09-05T20:11:47Z","html_url":"https://github.com/ramda/ramda/pull/1891#discussion_r77553811","pull_request_url":"https://api.github.com/repos/ramda/ramda/pulls/1891","_links":{"self":{"href":"https://api.github.com/repos/ramda/ramda/pulls/comments/77553811"},"html":{"href":"https://github.com/ramda/ramda/pull/1891#discussion_r77553811"},"pull_request":{"href":"https://api.github.com/repos/ramda/ramda/pulls/1891"}}},"pull_request":{"url":"https://api.github.com/repos/ramda/ramda/pulls/1891","id":84035906,"html_url":"https://github.com/ramda/ramda/pull/1891","diff_url":"https://github.com/ramda/ramda/pull/1891.diff","patch_url":"https://github.com/ramda/ramda/pull/1891.patch","issue_url":"https://api.github.com/repos/ramda/ramda/issues/1891","number":1891,"state":"open","locked":false,"title":"Clarify and unify docs","user":{"login":"ChrisPenner","id":6439644,"avatar_url":"https://avatars.githubusercontent.com/u/6439644?v=3","gravatar_id":"","url":"https://api.github.com/users/ChrisPenner","html_url":"https://github.com/ChrisPenner","followers_url":"https://api.github.com/users/ChrisPenner/followers","following_url":"https://api.github.com/users/ChrisPenner/following{/other_user}","gists_url":"https://api.github.com/users/ChrisPenner/gists{/gist_id}","starred_url":"https://api.github.com/users/ChrisPenner/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ChrisPenner/subscriptions","organizations_url":"https://api.github.com/users/ChrisPenner/orgs","repos_url":"https://api.github.com/users/ChrisPenner/repos","events_url":"https://api.github.com/users/ChrisPenner/events{/privacy}","received_events_url":"https://api.github.com/users/ChrisPenner/received_events","type":"User","site_admin":false},"body":"Hey folks, I've been getting more familiar with the lib lately and I think that the docs are one of Ramda's most valuable assets. For the most part they're very clear, but at parts they get a bit technical (which is fine, but the technical points should accompany simpler explanations).\r\n\r\nIn particular I've found several examples which would be much clearer if they used slightly different input. There are also several examples that require knowledge of advanced concepts which shouldn't be a requirement to learn that particular function.\r\n\r\nTo remedy some of this, I've been going through the docs one at a time and have been trying to clarify the docs wherever possible. As I go I'm also adding parameter annotations where they're missing and have been standardizing a few things like capitalization, etc.\r\n\r\nEach example is open for debate, I've done each doc as a separate commit for easy editing/exclusion, but once I've finished I'll squash it down. I'm still adding on (I'm going through alphabetically) but feel free to comment along the way.","created_at":"2016-09-05T19:53:21Z","updated_at":"2016-09-05T20:11:47Z","closed_at":null,"merged_at":null,"merge_commit_sha":"16292c1f5aab42b64dfa8702229b4232e483f50e","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/ramda/ramda/pulls/1891/commits","review_comments_url":"https://api.github.com/repos/ramda/ramda/pulls/1891/comments","review_comment_url":"https://api.github.com/repos/ramda/ramda/pulls/comments{/number}","comments_url":"https://api.github.com/repos/ramda/ramda/issues/1891/comments","statuses_url":"https://api.github.com/repos/ramda/ramda/statuses/b69200be730e9f574b3e9b7f07e0c25c466d9528","head":{"label":"ChrisPenner:clarify-docs","ref":"clarify-docs","sha":"b69200be730e9f574b3e9b7f07e0c25c466d9528","user":{"login":"ChrisPenner","id":6439644,"avatar_url":"https://avatars.githubusercontent.com/u/6439644?v=3","gravatar_id":"","url":"https://api.github.com/users/ChrisPenner","html_url":"https://github.com/ChrisPenner","followers_url":"https://api.github.com/users/ChrisPenner/followers","following_url":"https://api.github.com/users/ChrisPenner/following{/other_user}","gists_url":"https://api.github.com/users/ChrisPenner/gists{/gist_id}","starred_url":"https://api.github.com/users/ChrisPenner/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ChrisPenner/subscriptions","organizations_url":"https://api.github.com/users/ChrisPenner/orgs","repos_url":"https://api.github.com/users/ChrisPenner/repos","events_url":"https://api.github.com/users/ChrisPenner/events{/privacy}","received_events_url":"https://api.github.com/users/ChrisPenner/received_events","type":"User","site_admin":false},"repo":{"id":66608620,"name":"ramda","full_name":"ChrisPenner/ramda","owner":{"login":"ChrisPenner","id":6439644,"avatar_url":"https://avatars.githubusercontent.com/u/6439644?v=3","gravatar_id":"","url":"https://api.github.com/users/ChrisPenner","html_url":"https://github.com/ChrisPenner","followers_url":"https://api.github.com/users/ChrisPenner/followers","following_url":"https://api.github.com/users/ChrisPenner/following{/other_user}","gists_url":"https://api.github.com/users/ChrisPenner/gists{/gist_id}","starred_url":"https://api.github.com/users/ChrisPenner/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ChrisPenner/subscriptions","organizations_url":"https://api.github.com/users/ChrisPenner/orgs","repos_url":"https://api.github.com/users/ChrisPenner/repos","events_url":"https://api.github.com/users/ChrisPenner/events{/privacy}","received_events_url":"https://api.github.com/users/ChrisPenner/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/ChrisPenner/ramda","description":":ram: Practical functional Javascript","fork":true,"url":"https://api.github.com/repos/ChrisPenner/ramda","forks_url":"https://api.github.com/repos/ChrisPenner/ramda/forks","keys_url":"https://api.github.com/repos/ChrisPenner/ramda/keys{/key_id}","collaborators_url":"https://api.github.com/repos/ChrisPenner/ramda/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/ChrisPenner/ramda/teams","hooks_url":"https://api.github.com/repos/ChrisPenner/ramda/hooks","issue_events_url":"https://api.github.com/repos/ChrisPenner/ramda/issues/events{/number}","events_url":"https://api.github.com/repos/ChrisPenner/ramda/events","assignees_url":"https://api.github.com/repos/ChrisPenner/ramda/assignees{/user}","branches_url":"https://api.github.com/repos/ChrisPenner/ramda/branches{/branch}","tags_url":"https://api.github.com/repos/ChrisPenner/ramda/tags","blobs_url":"https://api.github.com/repos/ChrisPenner/ramda/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/ChrisPenner/ramda/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/ChrisPenner/ramda/git/refs{/sha}","trees_url":"https://api.github.com/repos/ChrisPenner/ramda/git/trees{/sha}","statuses_url":"https://api.github.com/repos/ChrisPenner/ramda/statuses/{sha}","languages_url":"https://api.github.com/repos/ChrisPenner/ramda/languages","stargazers_url":"https://api.github.com/repos/ChrisPenner/ramda/stargazers","contributors_url":"https://api.github.com/repos/ChrisPenner/ramda/contributors","subscribers_url":"https://api.github.com/repos/ChrisPenner/ramda/subscribers","subscription_url":"https://api.github.com/repos/ChrisPenner/ramda/subscription","commits_url":"https://api.github.com/repos/ChrisPenner/ramda/commits{/sha}","git_commits_url":"https://api.github.com/repos/ChrisPenner/ramda/git/commits{/sha}","comments_url":"https://api.github.com/repos/ChrisPenner/ramda/comments{/number}","issue_comment_url":"https://api.github.com/repos/ChrisPenner/ramda/issues/comments{/number}","contents_url":"https://api.github.com/repos/ChrisPenner/ramda/contents/{+path}","compare_url":"https://api.github.com/repos/ChrisPenner/ramda/compare/{base}...{head}","merges_url":"https://api.github.com/repos/ChrisPenner/ramda/merges","archive_url":"https://api.github.com/repos/ChrisPenner/ramda/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/ChrisPenner/ramda/downloads","issues_url":"https://api.github.com/repos/ChrisPenner/ramda/issues{/number}","pulls_url":"https://api.github.com/repos/ChrisPenner/ramda/pulls{/number}","milestones_url":"https://api.github.com/repos/ChrisPenner/ramda/milestones{/number}","notifications_url":"https://api.github.com/repos/ChrisPenner/ramda/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/ChrisPenner/ramda/labels{/name}","releases_url":"https://api.github.com/repos/ChrisPenner/ramda/releases{/id}","deployments_url":"https://api.github.com/repos/ChrisPenner/ramda/deployments","created_at":"2016-08-26T02:09:45Z","updated_at":"2016-08-26T02:09:47Z","pushed_at":"2016-09-05T19:39:50Z","git_url":"git://github.com/ChrisPenner/ramda.git","ssh_url":"git@github.com:ChrisPenner/ramda.git","clone_url":"https://github.com/ChrisPenner/ramda.git","svn_url":"https://github.com/ChrisPenner/ramda","homepage":"http://ramdajs.com","size":5941,"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":"ramda:master","ref":"master","sha":"1b819211d4f9146ee019cf24ca8e53a2945bdbf9","user":{"login":"ramda","id":5298359,"avatar_url":"https://avatars.githubusercontent.com/u/5298359?v=3","gravatar_id":"","url":"https://api.github.com/users/ramda","html_url":"https://github.com/ramda","followers_url":"https://api.github.com/users/ramda/followers","following_url":"https://api.github.com/users/ramda/following{/other_user}","gists_url":"https://api.github.com/users/ramda/gists{/gist_id}","starred_url":"https://api.github.com/users/ramda/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ramda/subscriptions","organizations_url":"https://api.github.com/users/ramda/orgs","repos_url":"https://api.github.com/users/ramda/repos","events_url":"https://api.github.com/users/ramda/events{/privacy}","received_events_url":"https://api.github.com/users/ramda/received_events","type":"Organization","site_admin":false},"repo":{"id":10851820,"name":"ramda","full_name":"ramda/ramda","owner":{"login":"ramda","id":5298359,"avatar_url":"https://avatars.githubusercontent.com/u/5298359?v=3","gravatar_id":"","url":"https://api.github.com/users/ramda","html_url":"https://github.com/ramda","followers_url":"https://api.github.com/users/ramda/followers","following_url":"https://api.github.com/users/ramda/following{/other_user}","gists_url":"https://api.github.com/users/ramda/gists{/gist_id}","starred_url":"https://api.github.com/users/ramda/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ramda/subscriptions","organizations_url":"https://api.github.com/users/ramda/orgs","repos_url":"https://api.github.com/users/ramda/repos","events_url":"https://api.github.com/users/ramda/events{/privacy}","received_events_url":"https://api.github.com/users/ramda/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/ramda/ramda","description":":ram: Practical functional Javascript","fork":false,"url":"https://api.github.com/repos/ramda/ramda","forks_url":"https://api.github.com/repos/ramda/ramda/forks","keys_url":"https://api.github.com/repos/ramda/ramda/keys{/key_id}","collaborators_url":"https://api.github.com/repos/ramda/ramda/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/ramda/ramda/teams","hooks_url":"https://api.github.com/repos/ramda/ramda/hooks","issue_events_url":"https://api.github.com/repos/ramda/ramda/issues/events{/number}","events_url":"https://api.github.com/repos/ramda/ramda/events","assignees_url":"https://api.github.com/repos/ramda/ramda/assignees{/user}","branches_url":"https://api.github.com/repos/ramda/ramda/branches{/branch}","tags_url":"https://api.github.com/repos/ramda/ramda/tags","blobs_url":"https://api.github.com/repos/ramda/ramda/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/ramda/ramda/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/ramda/ramda/git/refs{/sha}","trees_url":"https://api.github.com/repos/ramda/ramda/git/trees{/sha}","statuses_url":"https://api.github.com/repos/ramda/ramda/statuses/{sha}","languages_url":"https://api.github.com/repos/ramda/ramda/languages","stargazers_url":"https://api.github.com/repos/ramda/ramda/stargazers","contributors_url":"https://api.github.com/repos/ramda/ramda/contributors","subscribers_url":"https://api.github.com/repos/ramda/ramda/subscribers","subscription_url":"https://api.github.com/repos/ramda/ramda/subscription","commits_url":"https://api.github.com/repos/ramda/ramda/commits{/sha}","git_commits_url":"https://api.github.com/repos/ramda/ramda/git/commits{/sha}","comments_url":"https://api.github.com/repos/ramda/ramda/comments{/number}","issue_comment_url":"https://api.github.com/repos/ramda/ramda/issues/comments{/number}","contents_url":"https://api.github.com/repos/ramda/ramda/contents/{+path}","compare_url":"https://api.github.com/repos/ramda/ramda/compare/{base}...{head}","merges_url":"https://api.github.com/repos/ramda/ramda/merges","archive_url":"https://api.github.com/repos/ramda/ramda/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/ramda/ramda/downloads","issues_url":"https://api.github.com/repos/ramda/ramda/issues{/number}","pulls_url":"https://api.github.com/repos/ramda/ramda/pulls{/number}","milestones_url":"https://api.github.com/repos/ramda/ramda/milestones{/number}","notifications_url":"https://api.github.com/repos/ramda/ramda/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/ramda/ramda/labels{/name}","releases_url":"https://api.github.com/repos/ramda/ramda/releases{/id}","deployments_url":"https://api.github.com/repos/ramda/ramda/deployments","created_at":"2013-06-21T20:32:35Z","updated_at":"2016-09-05T19:27:12Z","pushed_at":"2016-09-05T19:53:21Z","git_url":"git://github.com/ramda/ramda.git","ssh_url":"git@github.com:ramda/ramda.git","clone_url":"https://github.com/ramda/ramda.git","svn_url":"https://github.com/ramda/ramda","homepage":"http://ramdajs.com","size":7555,"stargazers_count":5382,"watchers_count":5382,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":363,"mirror_url":null,"open_issues_count":158,"forks":363,"open_issues":158,"watchers":5382,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/ramda/ramda/pulls/1891"},"html":{"href":"https://github.com/ramda/ramda/pull/1891"},"issue":{"href":"https://api.github.com/repos/ramda/ramda/issues/1891"},"comments":{"href":"https://api.github.com/repos/ramda/ramda/issues/1891/comments"},"review_comments":{"href":"https://api.github.com/repos/ramda/ramda/pulls/1891/comments"},"review_comment":{"href":"https://api.github.com/repos/ramda/ramda/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/ramda/ramda/pulls/1891/commits"},"statuses":{"href":"https://api.github.com/repos/ramda/ramda/statuses/b69200be730e9f574b3e9b7f07e0c25c466d9528"}}}}
{"actor":{"display_login":"buzzdecafe"}}