{"action":"created","issue":{"url":"https://api.github.com/repos/elixir-lang/elixir-lang.github.com/issues/584","labels_url":"https://api.github.com/repos/elixir-lang/elixir-lang.github.com/issues/584/labels{/name}","comments_url":"https://api.github.com/repos/elixir-lang/elixir-lang.github.com/issues/584/comments","events_url":"https://api.github.com/repos/elixir-lang/elixir-lang.github.com/issues/584/events","html_url":"https://github.com/elixir-lang/elixir-lang.github.com/pull/584","id":101463513,"number":584,"title":"pipe operator clarification","user":{"login":"adamkittelson","id":54364,"avatar_url":"https://avatars.githubusercontent.com/u/54364?v=3","gravatar_id":"","url":"https://api.github.com/users/adamkittelson","html_url":"https://github.com/adamkittelson","followers_url":"https://api.github.com/users/adamkittelson/followers","following_url":"https://api.github.com/users/adamkittelson/following{/other_user}","gists_url":"https://api.github.com/users/adamkittelson/gists{/gist_id}","starred_url":"https://api.github.com/users/adamkittelson/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adamkittelson/subscriptions","organizations_url":"https://api.github.com/users/adamkittelson/orgs","repos_url":"https://api.github.com/users/adamkittelson/repos","events_url":"https://api.github.com/users/adamkittelson/events{/privacy}","received_events_url":"https://api.github.com/users/adamkittelson/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-08-17T16:51:03Z","updated_at":"2015-08-17T19:53:51Z","closed_at":"2015-08-17T19:53:50Z","pull_request":{"url":"https://api.github.com/repos/elixir-lang/elixir-lang.github.com/pulls/584","html_url":"https://github.com/elixir-lang/elixir-lang.github.com/pull/584","diff_url":"https://github.com/elixir-lang/elixir-lang.github.com/pull/584.diff","patch_url":"https://github.com/elixir-lang/elixir-lang.github.com/pull/584.patch"},"body":"A couple coworkers of mine attended the Phoenix training in Austin last week. Prior to that their only Elixir experience was the getting started guide.\r\n\r\nOne if them mentioned this:\r\n\r\n>By the way, about half-way through the second day of the training, Niko and I both had a revelation about understanding the `|>` operator...  The fact that it just passes the value in as the first argument.\r\n\r\n>Watching the code and thinking about it, some of the time we passed 3 args, and then sometimes 2 args, and while we got what the pipe operator does (generally speaking), the code was still hard to follow until that revelation...\r\n\r\n>The intro docs say \"it simply takes the output from the expression on its left side and passes it as the input to the function call on its right side.\"\r\n\r\n>But . . . that really doesn't make it clear.  Especially when a function has multiple arguments...  If they reworded that in the docs to say \"it simply takes the output from the expression on its left side and passes it as the first argument to the function call on its right side.\" it would have made a world of difference in following code early on.\r\n\r\nI double checked and the actual `Kernel.|>/2` docs say `This operator introduces the expression on the left as the first argument to the function call on the right.` so this just makes the getting started guide consistent with that.\r\n"},"comment":{"url":"https://api.github.com/repos/elixir-lang/elixir-lang.github.com/issues/comments/131942284","html_url":"https://github.com/elixir-lang/elixir-lang.github.com/pull/584#issuecomment-131942284","issue_url":"https://api.github.com/repos/elixir-lang/elixir-lang.github.com/issues/584","id":131942284,"user":{"login":"josevalim","id":9582,"avatar_url":"https://avatars.githubusercontent.com/u/9582?v=3","gravatar_id":"","url":"https://api.github.com/users/josevalim","html_url":"https://github.com/josevalim","followers_url":"https://api.github.com/users/josevalim/followers","following_url":"https://api.github.com/users/josevalim/following{/other_user}","gists_url":"https://api.github.com/users/josevalim/gists{/gist_id}","starred_url":"https://api.github.com/users/josevalim/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/josevalim/subscriptions","organizations_url":"https://api.github.com/users/josevalim/orgs","repos_url":"https://api.github.com/users/josevalim/repos","events_url":"https://api.github.com/users/josevalim/events{/privacy}","received_events_url":"https://api.github.com/users/josevalim/received_events","type":"User","site_admin":false},"created_at":"2015-08-17T19:53:51Z","updated_at":"2015-08-17T19:53:51Z","body":" :heart: :green_heart: :blue_heart: :yellow_heart: :purple_heart:"}}