{"action":"created","comment":{"url":"https://api.github.com/repos/elixir-lang/elixir/pulls/comments/199361357","pull_request_review_id":133465411,"id":199361357,"node_id":"MDI0OlB1bGxSZXF1ZXN0UmV2aWV3Q29tbWVudDE5OTM2MTM1Nw==","diff_hunk":"@@ -8,33 +8,29 @@ import :elixir_bootstrap\n \n defmodule Kernel do\n   @moduledoc \"\"\"\n-  This module is the entry point of the Elixir programming language.\n-\n-  It provides the default functions and macros Elixir imports into your\n-  environment. Those can be directly invoked in your code without the\n-  module name:\n-\n+  `Kernel` is Elixir's set of core functionality.\n+  \n+  It mainly consists of:\n+  \n+    * syntactic sugar - for more readable and intuitive code\n+    * [macros](https://elixir-lang.org/getting-started/meta/macros.html) - for defining new functionality\n+    * [guard](guards.html) checks - for more powerful function definitions\n+    \n+  `Kernel` is automatically imported into all `.ex` and `.exs` files,","path":"lib/elixir/lib/kernel.ex","position":18,"original_position":18,"commit_id":"986c68cde42b77bbefca76add78ea657933196b8","original_commit_id":"7b5799634cd1f2c8e875e74d55cd8dadf8219991","user":{"login":"whatyouhide","id":3890250,"node_id":"MDQ6VXNlcjM4OTAyNTA=","avatar_url":"https://avatars3.githubusercontent.com/u/3890250?v=4","gravatar_id":"","url":"https://api.github.com/users/whatyouhide","html_url":"https://github.com/whatyouhide","followers_url":"https://api.github.com/users/whatyouhide/followers","following_url":"https://api.github.com/users/whatyouhide/following{/other_user}","gists_url":"https://api.github.com/users/whatyouhide/gists{/gist_id}","starred_url":"https://api.github.com/users/whatyouhide/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/whatyouhide/subscriptions","organizations_url":"https://api.github.com/users/whatyouhide/orgs","repos_url":"https://api.github.com/users/whatyouhide/repos","events_url":"https://api.github.com/users/whatyouhide/events{/privacy}","received_events_url":"https://api.github.com/users/whatyouhide/received_events","type":"User","site_admin":false},"body":"Should we say that `Kernel` is automatically imported in all Elixir code, instead of just `.ex` and `.exs` files?","created_at":"2018-07-01T21:01:59Z","updated_at":"2018-07-01T21:05:25Z","html_url":"https://github.com/elixir-lang/elixir/pull/7821#discussion_r199361357","pull_request_url":"https://api.github.com/repos/elixir-lang/elixir/pulls/7821","author_association":"MEMBER","_links":{"self":{"href":"https://api.github.com/repos/elixir-lang/elixir/pulls/comments/199361357"},"html":{"href":"https://github.com/elixir-lang/elixir/pull/7821#discussion_r199361357"},"pull_request":{"href":"https://api.github.com/repos/elixir-lang/elixir/pulls/7821"}}},"pull_request":{"url":"https://api.github.com/repos/elixir-lang/elixir/pulls/7821","id":198533609,"node_id":"MDExOlB1bGxSZXF1ZXN0MTk4NTMzNjA5","html_url":"https://github.com/elixir-lang/elixir/pull/7821","diff_url":"https://github.com/elixir-lang/elixir/pull/7821.diff","patch_url":"https://github.com/elixir-lang/elixir/pull/7821.patch","issue_url":"https://api.github.com/repos/elixir-lang/elixir/issues/7821","number":7821,"state":"open","locked":false,"title":"Beginner-friendly revisions to Elixir's Hex documentation","user":{"login":"English3000","id":29601050,"node_id":"MDQ6VXNlcjI5NjAxMDUw","avatar_url":"https://avatars0.githubusercontent.com/u/29601050?v=4","gravatar_id":"","url":"https://api.github.com/users/English3000","html_url":"https://github.com/English3000","followers_url":"https://api.github.com/users/English3000/followers","following_url":"https://api.github.com/users/English3000/following{/other_user}","gists_url":"https://api.github.com/users/English3000/gists{/gist_id}","starred_url":"https://api.github.com/users/English3000/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/English3000/subscriptions","organizations_url":"https://api.github.com/users/English3000/orgs","repos_url":"https://api.github.com/users/English3000/repos","events_url":"https://api.github.com/users/English3000/events{/privacy}","received_events_url":"https://api.github.com/users/English3000/received_events","type":"User","site_admin":false},"body":"Where better to get feedback from than the source? As a relatively new user of Elixir (since v1.6) with a background in teaching methodology, here are a few suggestions to make the Hex documentation more helpful and intuitive for new users.\r\n\r\nFor context, see: \r\n\r\n* https://groups.google.com/forum/?utm_medium=email&utm_source=footer#!msg/elixir-lang-core/SAejGg2e-io/kpA_3qVVCAAJ\r\n* https://elixirforum.com/t/discussion-incorporating-erlang-otp-21-map-guards-in-elixir/14816/39\r\n\r\nPLEASE NOTE: These edits are meant as a starting point to confirm that the design decisions for the documentation--based on their merits--are viewed by the Elixir Core Team as steps in the right direction.\r\n\r\nWhen this is hopefully confirmed (if you are unconvinced that my revisions will be helpful, let's discuss your objections and get some feedback from beginners on my adjustments), I am happy to provide some deeper revisions in regard to the structure/organization of the core pages I have edited (or feel free to go ahead and implement the suggested comments in my respective commits yourself).\r\n\r\nThanks!","created_at":"2018-07-01T17:14:37Z","updated_at":"2018-07-01T21:05:25Z","closed_at":null,"merged_at":null,"merge_commit_sha":"eb66956407e14df2d05c433dc8da69c879d52008","assignee":null,"assignees":[],"requested_reviewers":[],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/elixir-lang/elixir/pulls/7821/commits","review_comments_url":"https://api.github.com/repos/elixir-lang/elixir/pulls/7821/comments","review_comment_url":"https://api.github.com/repos/elixir-lang/elixir/pulls/comments{/number}","comments_url":"https://api.github.com/repos/elixir-lang/elixir/issues/7821/comments","statuses_url":"https://api.github.com/repos/elixir-lang/elixir/statuses/986c68cde42b77bbefca76add78ea657933196b8","head":{"label":"English3000:master","ref":"master","sha":"986c68cde42b77bbefca76add78ea657933196b8","user":{"login":"English3000","id":29601050,"node_id":"MDQ6VXNlcjI5NjAxMDUw","avatar_url":"https://avatars0.githubusercontent.com/u/29601050?v=4","gravatar_id":"","url":"https://api.github.com/users/English3000","html_url":"https://github.com/English3000","followers_url":"https://api.github.com/users/English3000/followers","following_url":"https://api.github.com/users/English3000/following{/other_user}","gists_url":"https://api.github.com/users/English3000/gists{/gist_id}","starred_url":"https://api.github.com/users/English3000/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/English3000/subscriptions","organizations_url":"https://api.github.com/users/English3000/orgs","repos_url":"https://api.github.com/users/English3000/repos","events_url":"https://api.github.com/users/English3000/events{/privacy}","received_events_url":"https://api.github.com/users/English3000/received_events","type":"User","site_admin":false},"repo":{"id":139338355,"node_id":"MDEwOlJlcG9zaXRvcnkxMzkzMzgzNTU=","name":"elixir-lang","full_name":"English3000/elixir-lang","owner":{"login":"English3000","id":29601050,"node_id":"MDQ6VXNlcjI5NjAxMDUw","avatar_url":"https://avatars0.githubusercontent.com/u/29601050?v=4","gravatar_id":"","url":"https://api.github.com/users/English3000","html_url":"https://github.com/English3000","followers_url":"https://api.github.com/users/English3000/followers","following_url":"https://api.github.com/users/English3000/following{/other_user}","gists_url":"https://api.github.com/users/English3000/gists{/gist_id}","starred_url":"https://api.github.com/users/English3000/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/English3000/subscriptions","organizations_url":"https://api.github.com/users/English3000/orgs","repos_url":"https://api.github.com/users/English3000/repos","events_url":"https://api.github.com/users/English3000/events{/privacy}","received_events_url":"https://api.github.com/users/English3000/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/English3000/elixir-lang","description":"Elixir is a dynamic, functional language designed for building scalable and maintainable applications","fork":true,"url":"https://api.github.com/repos/English3000/elixir-lang","forks_url":"https://api.github.com/repos/English3000/elixir-lang/forks","keys_url":"https://api.github.com/repos/English3000/elixir-lang/keys{/key_id}","collaborators_url":"https://api.github.com/repos/English3000/elixir-lang/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/English3000/elixir-lang/teams","hooks_url":"https://api.github.com/repos/English3000/elixir-lang/hooks","issue_events_url":"https://api.github.com/repos/English3000/elixir-lang/issues/events{/number}","events_url":"https://api.github.com/repos/English3000/elixir-lang/events","assignees_url":"https://api.github.com/repos/English3000/elixir-lang/assignees{/user}","branches_url":"https://api.github.com/repos/English3000/elixir-lang/branches{/branch}","tags_url":"https://api.github.com/repos/English3000/elixir-lang/tags","blobs_url":"https://api.github.com/repos/English3000/elixir-lang/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/English3000/elixir-lang/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/English3000/elixir-lang/git/refs{/sha}","trees_url":"https://api.github.com/repos/English3000/elixir-lang/git/trees{/sha}","statuses_url":"https://api.github.com/repos/English3000/elixir-lang/statuses/{sha}","languages_url":"https://api.github.com/repos/English3000/elixir-lang/languages","stargazers_url":"https://api.github.com/repos/English3000/elixir-lang/stargazers","contributors_url":"https://api.github.com/repos/English3000/elixir-lang/contributors","subscribers_url":"https://api.github.com/repos/English3000/elixir-lang/subscribers","subscription_url":"https://api.github.com/repos/English3000/elixir-lang/subscription","commits_url":"https://api.github.com/repos/English3000/elixir-lang/commits{/sha}","git_commits_url":"https://api.github.com/repos/English3000/elixir-lang/git/commits{/sha}","comments_url":"https://api.github.com/repos/English3000/elixir-lang/comments{/number}","issue_comment_url":"https://api.github.com/repos/English3000/elixir-lang/issues/comments{/number}","contents_url":"https://api.github.com/repos/English3000/elixir-lang/contents/{+path}","compare_url":"https://api.github.com/repos/English3000/elixir-lang/compare/{base}...{head}","merges_url":"https://api.github.com/repos/English3000/elixir-lang/merges","archive_url":"https://api.github.com/repos/English3000/elixir-lang/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/English3000/elixir-lang/downloads","issues_url":"https://api.github.com/repos/English3000/elixir-lang/issues{/number}","pulls_url":"https://api.github.com/repos/English3000/elixir-lang/pulls{/number}","milestones_url":"https://api.github.com/repos/English3000/elixir-lang/milestones{/number}","notifications_url":"https://api.github.com/repos/English3000/elixir-lang/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/English3000/elixir-lang/labels{/name}","releases_url":"https://api.github.com/repos/English3000/elixir-lang/releases{/id}","deployments_url":"https://api.github.com/repos/English3000/elixir-lang/deployments","created_at":"2018-07-01T15:02:28Z","updated_at":"2018-07-01T21:02:54Z","pushed_at":"2018-07-01T21:02:52Z","git_url":"git://github.com/English3000/elixir-lang.git","ssh_url":"git@github.com:English3000/elixir-lang.git","clone_url":"https://github.com/English3000/elixir-lang.git","svn_url":"https://github.com/English3000/elixir-lang","homepage":"http://elixir-lang.org/","size":36911,"stargazers_count":0,"watchers_count":0,"language":"Elixir","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":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0","node_id":"MDc6TGljZW5zZTI="},"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"elixir-lang:master","ref":"master","sha":"6b5cb7014e9483861fcac703952425d0e68119c1","user":{"login":"elixir-lang","id":1481354,"node_id":"MDEyOk9yZ2FuaXphdGlvbjE0ODEzNTQ=","avatar_url":"https://avatars1.githubusercontent.com/u/1481354?v=4","gravatar_id":"","url":"https://api.github.com/users/elixir-lang","html_url":"https://github.com/elixir-lang","followers_url":"https://api.github.com/users/elixir-lang/followers","following_url":"https://api.github.com/users/elixir-lang/following{/other_user}","gists_url":"https://api.github.com/users/elixir-lang/gists{/gist_id}","starred_url":"https://api.github.com/users/elixir-lang/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/elixir-lang/subscriptions","organizations_url":"https://api.github.com/users/elixir-lang/orgs","repos_url":"https://api.github.com/users/elixir-lang/repos","events_url":"https://api.github.com/users/elixir-lang/events{/privacy}","received_events_url":"https://api.github.com/users/elixir-lang/received_events","type":"Organization","site_admin":false},"repo":{"id":1234714,"node_id":"MDEwOlJlcG9zaXRvcnkxMjM0NzE0","name":"elixir","full_name":"elixir-lang/elixir","owner":{"login":"elixir-lang","id":1481354,"node_id":"MDEyOk9yZ2FuaXphdGlvbjE0ODEzNTQ=","avatar_url":"https://avatars1.githubusercontent.com/u/1481354?v=4","gravatar_id":"","url":"https://api.github.com/users/elixir-lang","html_url":"https://github.com/elixir-lang","followers_url":"https://api.github.com/users/elixir-lang/followers","following_url":"https://api.github.com/users/elixir-lang/following{/other_user}","gists_url":"https://api.github.com/users/elixir-lang/gists{/gist_id}","starred_url":"https://api.github.com/users/elixir-lang/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/elixir-lang/subscriptions","organizations_url":"https://api.github.com/users/elixir-lang/orgs","repos_url":"https://api.github.com/users/elixir-lang/repos","events_url":"https://api.github.com/users/elixir-lang/events{/privacy}","received_events_url":"https://api.github.com/users/elixir-lang/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/elixir-lang/elixir","description":"Elixir is a dynamic, functional language designed for building scalable and maintainable applications","fork":false,"url":"https://api.github.com/repos/elixir-lang/elixir","forks_url":"https://api.github.com/repos/elixir-lang/elixir/forks","keys_url":"https://api.github.com/repos/elixir-lang/elixir/keys{/key_id}","collaborators_url":"https://api.github.com/repos/elixir-lang/elixir/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/elixir-lang/elixir/teams","hooks_url":"https://api.github.com/repos/elixir-lang/elixir/hooks","issue_events_url":"https://api.github.com/repos/elixir-lang/elixir/issues/events{/number}","events_url":"https://api.github.com/repos/elixir-lang/elixir/events","assignees_url":"https://api.github.com/repos/elixir-lang/elixir/assignees{/user}","branches_url":"https://api.github.com/repos/elixir-lang/elixir/branches{/branch}","tags_url":"https://api.github.com/repos/elixir-lang/elixir/tags","blobs_url":"https://api.github.com/repos/elixir-lang/elixir/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/elixir-lang/elixir/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/elixir-lang/elixir/git/refs{/sha}","trees_url":"https://api.github.com/repos/elixir-lang/elixir/git/trees{/sha}","statuses_url":"https://api.github.com/repos/elixir-lang/elixir/statuses/{sha}","languages_url":"https://api.github.com/repos/elixir-lang/elixir/languages","stargazers_url":"https://api.github.com/repos/elixir-lang/elixir/stargazers","contributors_url":"https://api.github.com/repos/elixir-lang/elixir/contributors","subscribers_url":"https://api.github.com/repos/elixir-lang/elixir/subscribers","subscription_url":"https://api.github.com/repos/elixir-lang/elixir/subscription","commits_url":"https://api.github.com/repos/elixir-lang/elixir/commits{/sha}","git_commits_url":"https://api.github.com/repos/elixir-lang/elixir/git/commits{/sha}","comments_url":"https://api.github.com/repos/elixir-lang/elixir/comments{/number}","issue_comment_url":"https://api.github.com/repos/elixir-lang/elixir/issues/comments{/number}","contents_url":"https://api.github.com/repos/elixir-lang/elixir/contents/{+path}","compare_url":"https://api.github.com/repos/elixir-lang/elixir/compare/{base}...{head}","merges_url":"https://api.github.com/repos/elixir-lang/elixir/merges","archive_url":"https://api.github.com/repos/elixir-lang/elixir/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/elixir-lang/elixir/downloads","issues_url":"https://api.github.com/repos/elixir-lang/elixir/issues{/number}","pulls_url":"https://api.github.com/repos/elixir-lang/elixir/pulls{/number}","milestones_url":"https://api.github.com/repos/elixir-lang/elixir/milestones{/number}","notifications_url":"https://api.github.com/repos/elixir-lang/elixir/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/elixir-lang/elixir/labels{/name}","releases_url":"https://api.github.com/repos/elixir-lang/elixir/releases{/id}","deployments_url":"https://api.github.com/repos/elixir-lang/elixir/deployments","created_at":"2011-01-09T08:43:57Z","updated_at":"2018-07-01T20:35:19Z","pushed_at":"2018-07-01T21:02:53Z","git_url":"git://github.com/elixir-lang/elixir.git","ssh_url":"git@github.com:elixir-lang/elixir.git","clone_url":"https://github.com/elixir-lang/elixir.git","svn_url":"https://github.com/elixir-lang/elixir","homepage":"http://elixir-lang.org/","size":36822,"stargazers_count":13198,"watchers_count":13198,"language":"Elixir","has_issues":true,"has_projects":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":1935,"mirror_url":null,"archived":false,"open_issues_count":33,"license":{"key":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0","node_id":"MDc6TGljZW5zZTI="},"forks":1935,"open_issues":33,"watchers":13198,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/elixir-lang/elixir/pulls/7821"},"html":{"href":"https://github.com/elixir-lang/elixir/pull/7821"},"issue":{"href":"https://api.github.com/repos/elixir-lang/elixir/issues/7821"},"comments":{"href":"https://api.github.com/repos/elixir-lang/elixir/issues/7821/comments"},"review_comments":{"href":"https://api.github.com/repos/elixir-lang/elixir/pulls/7821/comments"},"review_comment":{"href":"https://api.github.com/repos/elixir-lang/elixir/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/elixir-lang/elixir/pulls/7821/commits"},"statuses":{"href":"https://api.github.com/repos/elixir-lang/elixir/statuses/986c68cde42b77bbefca76add78ea657933196b8"}},"author_association":"NONE"}}
{"actor":{"display_login":"whatyouhide"}}