{"action":"created","comment":{"url":"https://api.github.com/repos/graknlabs/grakn/pulls/comments/180583237","pull_request_review_id":111029732,"id":180583237,"diff_hunk":"@@ -11,15 +11,17 @@ toc: false\n KB: academy\n ---\n \n-As anticipated in the [last lesson](./reasoner-intro.html), in this module you are going to learn how to use Grakn Reasoner to make your data more intelligent.\n+As anticipated in the [last lesson](./reasoner-intro.html), in this module you are going to learn how to use the Grakn Reasoner to make your data more intelligent.\n \n-Among others, the two most common uses for Reasoner are:\n-Knowledge discovery: as in the deserted island example you have read about in the last lesson, we can use logic inference to extract more knowledge out of our data without modifying it.\n-Query shortening: sometimes you use the same long query over and over again. It is convenient in those cases to use reasoner to simply create new \"virtual\" relationship that will make running those same queries in a more succint way.\n-In this and the following lesson, we will build an example that will demonstrate both these points.\n+Among others, the two most common uses for reasoners are:\n+\n+  1. Knowledge discovery: as in the deserted island example you have read about in the last lesson, we can use logic inference to extract more knowledge out of our data without modifying it.\n+  1. Query shortening: sometimes you use the same long query over and over again. It is convenient in those cases to use reasoners to simply create new \"virtual\" relationships that make those same queries more succint.\n+\n+In this and the following lesson, we will build an example that will demonstrate both use cases.","path":"docs/pages/academy/5-reasoner/2-inference-rules.md","position":25,"original_position":25,"commit_id":"d6d8b371136e7bd83ef2b5e5e8c63fda197b4326","original_commit_id":"d6d8b371136e7bd83ef2b5e5e8c63fda197b4326","user":{"login":"WalternativE","id":5071748,"avatar_url":"https://avatars3.githubusercontent.com/u/5071748?v=4","gravatar_id":"","url":"https://api.github.com/users/WalternativE","html_url":"https://github.com/WalternativE","followers_url":"https://api.github.com/users/WalternativE/followers","following_url":"https://api.github.com/users/WalternativE/following{/other_user}","gists_url":"https://api.github.com/users/WalternativE/gists{/gist_id}","starred_url":"https://api.github.com/users/WalternativE/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/WalternativE/subscriptions","organizations_url":"https://api.github.com/users/WalternativE/orgs","repos_url":"https://api.github.com/users/WalternativE/repos","events_url":"https://api.github.com/users/WalternativE/events{/privacy}","received_events_url":"https://api.github.com/users/WalternativE/received_events","type":"User","site_admin":false},"body":"I'll treat it as a big change then and put it in the respective pull request. Both points are numbered 1. because markdown processors usually take the collection of items and enumerate them in the transpilation process. There are a couple of other documents in the academy using this style (only one in which the items are enumerated \"by hand\" - which I didn't change because I saw no reason to do so). ","created_at":"2018-04-10T22:13:42Z","updated_at":"2018-04-10T22:13:43Z","html_url":"https://github.com/graknlabs/grakn/pull/2752#discussion_r180583237","pull_request_url":"https://api.github.com/repos/graknlabs/grakn/pulls/2752","author_association":"NONE","_links":{"self":{"href":"https://api.github.com/repos/graknlabs/grakn/pulls/comments/180583237"},"html":{"href":"https://github.com/graknlabs/grakn/pull/2752#discussion_r180583237"},"pull_request":{"href":"https://api.github.com/repos/graknlabs/grakn/pulls/2752"}},"in_reply_to_id":180405427},"pull_request":{"url":"https://api.github.com/repos/graknlabs/grakn/pulls/2752","id":180189979,"html_url":"https://github.com/graknlabs/grakn/pull/2752","diff_url":"https://github.com/graknlabs/grakn/pull/2752.diff","patch_url":"https://github.com/graknlabs/grakn/pull/2752.patch","issue_url":"https://api.github.com/repos/graknlabs/grakn/issues/2752","number":2752,"state":"open","locked":false,"title":"Corrections and adaptions to academy tutorial","user":{"login":"WalternativE","id":5071748,"avatar_url":"https://avatars3.githubusercontent.com/u/5071748?v=4","gravatar_id":"","url":"https://api.github.com/users/WalternativE","html_url":"https://github.com/WalternativE","followers_url":"https://api.github.com/users/WalternativE/followers","following_url":"https://api.github.com/users/WalternativE/following{/other_user}","gists_url":"https://api.github.com/users/WalternativE/gists{/gist_id}","starred_url":"https://api.github.com/users/WalternativE/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/WalternativE/subscriptions","organizations_url":"https://api.github.com/users/WalternativE/orgs","repos_url":"https://api.github.com/users/WalternativE/repos","events_url":"https://api.github.com/users/WalternativE/events{/privacy}","received_events_url":"https://api.github.com/users/WalternativE/received_events","type":"User","site_admin":false},"body":"As mentioned in the Slack channel I worked through the Academy tutorial and adapted the docs wherever I found something that seemed worth to correct. I'm by no means a professional editor so my PR is neither fully complete nor 100% correct.\r\n\r\nBesides typos, obvious grammar mishaps and small wording issues. I tried to adapt the tutorial whenever I found an instruction that went out of sync with the current version of Grakn (like the changes in the delete statement documentation, the centrality, and other graph computations). Apparently, there once was the plan to distribute this tutorial with a VM - as there is no set of instructions how to set it up and no other technical trace in any repo where this VM should be located I generalized the instructions for the usage with a local Grakn instance.\r\n\r\nThe files `5-schema-review.md` as well as `1-loading-files.md` include depictions and descriptions of a more general schema viewer. I couldn't reproduce them on my own nor did I find something in the documentation which would have pointed me in the right direction. As I don't know if I just wasn't able to produce the right outcome I didn't rewrite and illustrate those parts.\r\n\r\nIt appears that the academy docs were initially published before the official wording was changed to \"knowledge graph\" in favor of \"knowledge base\". I'm not entirely sure if I got every usage quite right.\r\n\r\nThe schema in the academy example contains a definition for an attribute called `company-id` - I wasn't able to find any usage of this attribute in the schema or in any exercise, but as I don't know too much about the original author's intention I didn't set an action in any direction (would be a PR for the academy files repo anyway).\r\n\r\nThe analytics module seems to need far more work as there was so much functionality added to Grakn. I just changed a couple of paragraphs and code snippets to make the module work again for new learners. I also changed the illustrations which depicted the old snippets and their result representations (mostly related to the new `compute centrality ...; using` and `compute cluster ...; using` syntax).\r\n\r\nIf I introduced any mistakes please let me know and I'll adapt this PR asap.","created_at":"2018-04-09T00:38:04Z","updated_at":"2018-04-10T22:13:43Z","closed_at":null,"merged_at":null,"merge_commit_sha":"fef86396fb73831b593aabab461724f149fc4c33","assignee":null,"assignees":[],"requested_reviewers":[{"login":"lolski","id":464164,"avatar_url":"https://avatars0.githubusercontent.com/u/464164?v=4","gravatar_id":"","url":"https://api.github.com/users/lolski","html_url":"https://github.com/lolski","followers_url":"https://api.github.com/users/lolski/followers","following_url":"https://api.github.com/users/lolski/following{/other_user}","gists_url":"https://api.github.com/users/lolski/gists{/gist_id}","starred_url":"https://api.github.com/users/lolski/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lolski/subscriptions","organizations_url":"https://api.github.com/users/lolski/orgs","repos_url":"https://api.github.com/users/lolski/repos","events_url":"https://api.github.com/users/lolski/events{/privacy}","received_events_url":"https://api.github.com/users/lolski/received_events","type":"User","site_admin":false}],"requested_teams":[],"labels":[{"id":612008349,"url":"https://api.github.com/repos/graknlabs/grakn/labels/stable","name":"stable","color":"d4c5f9","default":false}],"milestone":null,"commits_url":"https://api.github.com/repos/graknlabs/grakn/pulls/2752/commits","review_comments_url":"https://api.github.com/repos/graknlabs/grakn/pulls/2752/comments","review_comment_url":"https://api.github.com/repos/graknlabs/grakn/pulls/comments{/number}","comments_url":"https://api.github.com/repos/graknlabs/grakn/issues/2752/comments","statuses_url":"https://api.github.com/repos/graknlabs/grakn/statuses/d6d8b371136e7bd83ef2b5e5e8c63fda197b4326","head":{"label":"WalternativE:docs-changes","ref":"docs-changes","sha":"d6d8b371136e7bd83ef2b5e5e8c63fda197b4326","user":{"login":"WalternativE","id":5071748,"avatar_url":"https://avatars3.githubusercontent.com/u/5071748?v=4","gravatar_id":"","url":"https://api.github.com/users/WalternativE","html_url":"https://github.com/WalternativE","followers_url":"https://api.github.com/users/WalternativE/followers","following_url":"https://api.github.com/users/WalternativE/following{/other_user}","gists_url":"https://api.github.com/users/WalternativE/gists{/gist_id}","starred_url":"https://api.github.com/users/WalternativE/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/WalternativE/subscriptions","organizations_url":"https://api.github.com/users/WalternativE/orgs","repos_url":"https://api.github.com/users/WalternativE/repos","events_url":"https://api.github.com/users/WalternativE/events{/privacy}","received_events_url":"https://api.github.com/users/WalternativE/received_events","type":"User","site_admin":false},"repo":{"id":128370292,"name":"grakn","full_name":"WalternativE/grakn","owner":{"login":"WalternativE","id":5071748,"avatar_url":"https://avatars3.githubusercontent.com/u/5071748?v=4","gravatar_id":"","url":"https://api.github.com/users/WalternativE","html_url":"https://github.com/WalternativE","followers_url":"https://api.github.com/users/WalternativE/followers","following_url":"https://api.github.com/users/WalternativE/following{/other_user}","gists_url":"https://api.github.com/users/WalternativE/gists{/gist_id}","starred_url":"https://api.github.com/users/WalternativE/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/WalternativE/subscriptions","organizations_url":"https://api.github.com/users/WalternativE/orgs","repos_url":"https://api.github.com/users/WalternativE/repos","events_url":"https://api.github.com/users/WalternativE/events{/privacy}","received_events_url":"https://api.github.com/users/WalternativE/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/WalternativE/grakn","description":"The Knowledge Graph","fork":true,"url":"https://api.github.com/repos/WalternativE/grakn","forks_url":"https://api.github.com/repos/WalternativE/grakn/forks","keys_url":"https://api.github.com/repos/WalternativE/grakn/keys{/key_id}","collaborators_url":"https://api.github.com/repos/WalternativE/grakn/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/WalternativE/grakn/teams","hooks_url":"https://api.github.com/repos/WalternativE/grakn/hooks","issue_events_url":"https://api.github.com/repos/WalternativE/grakn/issues/events{/number}","events_url":"https://api.github.com/repos/WalternativE/grakn/events","assignees_url":"https://api.github.com/repos/WalternativE/grakn/assignees{/user}","branches_url":"https://api.github.com/repos/WalternativE/grakn/branches{/branch}","tags_url":"https://api.github.com/repos/WalternativE/grakn/tags","blobs_url":"https://api.github.com/repos/WalternativE/grakn/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/WalternativE/grakn/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/WalternativE/grakn/git/refs{/sha}","trees_url":"https://api.github.com/repos/WalternativE/grakn/git/trees{/sha}","statuses_url":"https://api.github.com/repos/WalternativE/grakn/statuses/{sha}","languages_url":"https://api.github.com/repos/WalternativE/grakn/languages","stargazers_url":"https://api.github.com/repos/WalternativE/grakn/stargazers","contributors_url":"https://api.github.com/repos/WalternativE/grakn/contributors","subscribers_url":"https://api.github.com/repos/WalternativE/grakn/subscribers","subscription_url":"https://api.github.com/repos/WalternativE/grakn/subscription","commits_url":"https://api.github.com/repos/WalternativE/grakn/commits{/sha}","git_commits_url":"https://api.github.com/repos/WalternativE/grakn/git/commits{/sha}","comments_url":"https://api.github.com/repos/WalternativE/grakn/comments{/number}","issue_comment_url":"https://api.github.com/repos/WalternativE/grakn/issues/comments{/number}","contents_url":"https://api.github.com/repos/WalternativE/grakn/contents/{+path}","compare_url":"https://api.github.com/repos/WalternativE/grakn/compare/{base}...{head}","merges_url":"https://api.github.com/repos/WalternativE/grakn/merges","archive_url":"https://api.github.com/repos/WalternativE/grakn/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/WalternativE/grakn/downloads","issues_url":"https://api.github.com/repos/WalternativE/grakn/issues{/number}","pulls_url":"https://api.github.com/repos/WalternativE/grakn/pulls{/number}","milestones_url":"https://api.github.com/repos/WalternativE/grakn/milestones{/number}","notifications_url":"https://api.github.com/repos/WalternativE/grakn/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/WalternativE/grakn/labels{/name}","releases_url":"https://api.github.com/repos/WalternativE/grakn/releases{/id}","deployments_url":"https://api.github.com/repos/WalternativE/grakn/deployments","created_at":"2018-04-06T08:38:34Z","updated_at":"2018-04-06T08:38:39Z","pushed_at":"2018-04-10T22:07:59Z","git_url":"git://github.com/WalternativE/grakn.git","ssh_url":"git@github.com:WalternativE/grakn.git","clone_url":"https://github.com/WalternativE/grakn.git","svn_url":"https://github.com/WalternativE/grakn","homepage":"https://grakn.ai","size":57165,"stargazers_count":0,"watchers_count":0,"language":"Java","has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"archived":false,"open_issues_count":0,"license":{"key":"agpl-3.0","name":"GNU Affero General Public License v3.0","spdx_id":"AGPL-3.0","url":"https://api.github.com/licenses/agpl-3.0"},"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"graknlabs:stable","ref":"stable","sha":"d10f1bc8ab96ea5d0b8c1b57b755b97cdfd2eb64","user":{"login":"graknlabs","id":10490615,"avatar_url":"https://avatars1.githubusercontent.com/u/10490615?v=4","gravatar_id":"","url":"https://api.github.com/users/graknlabs","html_url":"https://github.com/graknlabs","followers_url":"https://api.github.com/users/graknlabs/followers","following_url":"https://api.github.com/users/graknlabs/following{/other_user}","gists_url":"https://api.github.com/users/graknlabs/gists{/gist_id}","starred_url":"https://api.github.com/users/graknlabs/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/graknlabs/subscriptions","organizations_url":"https://api.github.com/users/graknlabs/orgs","repos_url":"https://api.github.com/users/graknlabs/repos","events_url":"https://api.github.com/users/graknlabs/events{/privacy}","received_events_url":"https://api.github.com/users/graknlabs/received_events","type":"Organization","site_admin":false},"repo":{"id":63110867,"name":"grakn","full_name":"graknlabs/grakn","owner":{"login":"graknlabs","id":10490615,"avatar_url":"https://avatars1.githubusercontent.com/u/10490615?v=4","gravatar_id":"","url":"https://api.github.com/users/graknlabs","html_url":"https://github.com/graknlabs","followers_url":"https://api.github.com/users/graknlabs/followers","following_url":"https://api.github.com/users/graknlabs/following{/other_user}","gists_url":"https://api.github.com/users/graknlabs/gists{/gist_id}","starred_url":"https://api.github.com/users/graknlabs/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/graknlabs/subscriptions","organizations_url":"https://api.github.com/users/graknlabs/orgs","repos_url":"https://api.github.com/users/graknlabs/repos","events_url":"https://api.github.com/users/graknlabs/events{/privacy}","received_events_url":"https://api.github.com/users/graknlabs/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/graknlabs/grakn","description":"The Knowledge Graph","fork":false,"url":"https://api.github.com/repos/graknlabs/grakn","forks_url":"https://api.github.com/repos/graknlabs/grakn/forks","keys_url":"https://api.github.com/repos/graknlabs/grakn/keys{/key_id}","collaborators_url":"https://api.github.com/repos/graknlabs/grakn/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/graknlabs/grakn/teams","hooks_url":"https://api.github.com/repos/graknlabs/grakn/hooks","issue_events_url":"https://api.github.com/repos/graknlabs/grakn/issues/events{/number}","events_url":"https://api.github.com/repos/graknlabs/grakn/events","assignees_url":"https://api.github.com/repos/graknlabs/grakn/assignees{/user}","branches_url":"https://api.github.com/repos/graknlabs/grakn/branches{/branch}","tags_url":"https://api.github.com/repos/graknlabs/grakn/tags","blobs_url":"https://api.github.com/repos/graknlabs/grakn/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/graknlabs/grakn/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/graknlabs/grakn/git/refs{/sha}","trees_url":"https://api.github.com/repos/graknlabs/grakn/git/trees{/sha}","statuses_url":"https://api.github.com/repos/graknlabs/grakn/statuses/{sha}","languages_url":"https://api.github.com/repos/graknlabs/grakn/languages","stargazers_url":"https://api.github.com/repos/graknlabs/grakn/stargazers","contributors_url":"https://api.github.com/repos/graknlabs/grakn/contributors","subscribers_url":"https://api.github.com/repos/graknlabs/grakn/subscribers","subscription_url":"https://api.github.com/repos/graknlabs/grakn/subscription","commits_url":"https://api.github.com/repos/graknlabs/grakn/commits{/sha}","git_commits_url":"https://api.github.com/repos/graknlabs/grakn/git/commits{/sha}","comments_url":"https://api.github.com/repos/graknlabs/grakn/comments{/number}","issue_comment_url":"https://api.github.com/repos/graknlabs/grakn/issues/comments{/number}","contents_url":"https://api.github.com/repos/graknlabs/grakn/contents/{+path}","compare_url":"https://api.github.com/repos/graknlabs/grakn/compare/{base}...{head}","merges_url":"https://api.github.com/repos/graknlabs/grakn/merges","archive_url":"https://api.github.com/repos/graknlabs/grakn/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/graknlabs/grakn/downloads","issues_url":"https://api.github.com/repos/graknlabs/grakn/issues{/number}","pulls_url":"https://api.github.com/repos/graknlabs/grakn/pulls{/number}","milestones_url":"https://api.github.com/repos/graknlabs/grakn/milestones{/number}","notifications_url":"https://api.github.com/repos/graknlabs/grakn/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/graknlabs/grakn/labels{/name}","releases_url":"https://api.github.com/repos/graknlabs/grakn/releases{/id}","deployments_url":"https://api.github.com/repos/graknlabs/grakn/deployments","created_at":"2016-07-11T23:59:57Z","updated_at":"2018-04-10T00:08:00Z","pushed_at":"2018-04-10T18:21:43Z","git_url":"git://github.com/graknlabs/grakn.git","ssh_url":"git@github.com:graknlabs/grakn.git","clone_url":"https://github.com/graknlabs/grakn.git","svn_url":"https://github.com/graknlabs/grakn","homepage":"https://grakn.ai","size":57040,"stargazers_count":887,"watchers_count":887,"language":"Java","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":119,"mirror_url":null,"archived":false,"open_issues_count":34,"license":{"key":"agpl-3.0","name":"GNU Affero General Public License v3.0","spdx_id":"AGPL-3.0","url":"https://api.github.com/licenses/agpl-3.0"},"forks":119,"open_issues":34,"watchers":887,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/graknlabs/grakn/pulls/2752"},"html":{"href":"https://github.com/graknlabs/grakn/pull/2752"},"issue":{"href":"https://api.github.com/repos/graknlabs/grakn/issues/2752"},"comments":{"href":"https://api.github.com/repos/graknlabs/grakn/issues/2752/comments"},"review_comments":{"href":"https://api.github.com/repos/graknlabs/grakn/pulls/2752/comments"},"review_comment":{"href":"https://api.github.com/repos/graknlabs/grakn/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/graknlabs/grakn/pulls/2752/commits"},"statuses":{"href":"https://api.github.com/repos/graknlabs/grakn/statuses/d6d8b371136e7bd83ef2b5e5e8c63fda197b4326"}},"author_association":"NONE"}}
{"actor":{"display_login":"WalternativE"}}