{"action":"created","issue":{"url":"https://api.github.com/repos/elixir-lang/elixir/issues/3226","labels_url":"https://api.github.com/repos/elixir-lang/elixir/issues/3226/labels{/name}","comments_url":"https://api.github.com/repos/elixir-lang/elixir/issues/3226/comments","events_url":"https://api.github.com/repos/elixir-lang/elixir/issues/3226/events","html_url":"https://github.com/elixir-lang/elixir/issues/3226","id":65409506,"number":3226,"title":"Documention, known keywords as placeholder","user":{"login":"andreas-roehler","id":1173139,"avatar_url":"https://avatars.githubusercontent.com/u/1173139?v=3","gravatar_id":"","url":"https://api.github.com/users/andreas-roehler","html_url":"https://github.com/andreas-roehler","followers_url":"https://api.github.com/users/andreas-roehler/followers","following_url":"https://api.github.com/users/andreas-roehler/following{/other_user}","gists_url":"https://api.github.com/users/andreas-roehler/gists{/gist_id}","starred_url":"https://api.github.com/users/andreas-roehler/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/andreas-roehler/subscriptions","organizations_url":"https://api.github.com/users/andreas-roehler/orgs","repos_url":"https://api.github.com/users/andreas-roehler/repos","events_url":"https://api.github.com/users/andreas-roehler/events{/privacy}","received_events_url":"https://api.github.com/users/andreas-roehler/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-03-31T09:37:28Z","updated_at":"2015-03-31T10:54:52Z","closed_at":null,"body":"Suggest not to use widely known symbols as place-holder. These might be taken for symbols pointing at implemented stuff.\r\n\r\nelixir-lang.readthedocs.org/en/latest/ref/master/elixir/Stream/index.html#module-Stream:\r\n\r\niex> Enum.map range, &(&1 * 2)\r\n[2,4,6,8,10]\r\n\r\nProblem: range is a well known function in other languages, but used as an arbitrary identifier here:\r\n\r\niex> range = 1..5\r\n1..5\r\n\r\nWhile understanding the rationale behind this \"speaking indentifier\", it might create confusion.\r\n\"my_var\" would be preferable, resp. \"baz\""},"comment":{"url":"https://api.github.com/repos/elixir-lang/elixir/issues/comments/88041506","html_url":"https://github.com/elixir-lang/elixir/issues/3226#issuecomment-88041506","issue_url":"https://api.github.com/repos/elixir-lang/elixir/issues/3226","id":88041506,"user":{"login":"lexmag","id":248290,"avatar_url":"https://avatars.githubusercontent.com/u/248290?v=3","gravatar_id":"","url":"https://api.github.com/users/lexmag","html_url":"https://github.com/lexmag","followers_url":"https://api.github.com/users/lexmag/followers","following_url":"https://api.github.com/users/lexmag/following{/other_user}","gists_url":"https://api.github.com/users/lexmag/gists{/gist_id}","starred_url":"https://api.github.com/users/lexmag/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lexmag/subscriptions","organizations_url":"https://api.github.com/users/lexmag/orgs","repos_url":"https://api.github.com/users/lexmag/repos","events_url":"https://api.github.com/users/lexmag/events{/privacy}","received_events_url":"https://api.github.com/users/lexmag/received_events","type":"User","site_admin":false},"created_at":"2015-03-31T10:54:52Z","updated_at":"2015-03-31T10:54:52Z","body":"As for me, I think it's a correct naming since `range` variable represents `Range` data type.\r\nBTW there is the [elixir-lang-core](https://groups.google.com/forum/#!forum/elixir-lang-core) mailing list for that kind discussions. :)"}}