{"action":"created","issue":{"url":"https://api.github.com/repos/hylang/hy/issues/961","labels_url":"https://api.github.com/repos/hylang/hy/issues/961/labels{/name}","comments_url":"https://api.github.com/repos/hylang/hy/issues/961/comments","events_url":"https://api.github.com/repos/hylang/hy/issues/961/events","html_url":"https://github.com/hylang/hy/issues/961","id":111288047,"number":961,"title":"document &key","user":{"login":"gilch","id":3346292,"avatar_url":"https://avatars.githubusercontent.com/u/3346292?v=3","gravatar_id":"","url":"https://api.github.com/users/gilch","html_url":"https://github.com/gilch","followers_url":"https://api.github.com/users/gilch/followers","following_url":"https://api.github.com/users/gilch/following{/other_user}","gists_url":"https://api.github.com/users/gilch/gists{/gist_id}","starred_url":"https://api.github.com/users/gilch/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/gilch/subscriptions","organizations_url":"https://api.github.com/users/gilch/orgs","repos_url":"https://api.github.com/users/gilch/repos","events_url":"https://api.github.com/users/gilch/events{/privacy}","received_events_url":"https://api.github.com/users/gilch/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/hylang/hy/labels/docmebro","name":"docmebro","color":"ffaa99"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-10-13T22:52:28Z","updated_at":"2015-10-14T22:27:12Z","closed_at":null,"body":"The docs for `defn` seem to say `&key` exists, but there are no examples. If it's a just a misprint and doesn't actually exist, it should be removed. Otherwise, it needs examples."},"comment":{"url":"https://api.github.com/repos/hylang/hy/issues/comments/148220967","html_url":"https://github.com/hylang/hy/issues/961#issuecomment-148220967","issue_url":"https://api.github.com/repos/hylang/hy/issues/961","id":148220967,"user":{"login":"kirbyfan64","id":1690697,"avatar_url":"https://avatars.githubusercontent.com/u/1690697?v=3","gravatar_id":"","url":"https://api.github.com/users/kirbyfan64","html_url":"https://github.com/kirbyfan64","followers_url":"https://api.github.com/users/kirbyfan64/followers","following_url":"https://api.github.com/users/kirbyfan64/following{/other_user}","gists_url":"https://api.github.com/users/kirbyfan64/gists{/gist_id}","starred_url":"https://api.github.com/users/kirbyfan64/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kirbyfan64/subscriptions","organizations_url":"https://api.github.com/users/kirbyfan64/orgs","repos_url":"https://api.github.com/users/kirbyfan64/repos","events_url":"https://api.github.com/users/kirbyfan64/events{/privacy}","received_events_url":"https://api.github.com/users/kirbyfan64/received_events","type":"User","site_admin":false},"created_at":"2015-10-14T22:27:12Z","updated_at":"2015-10-14T22:27:12Z","body":"> there are no examples\r\n\r\nUhhh...\r\n\r\nhttp://docs.hylang.org/en/latest/tutorial.html\r\n\r\nBasically:\r\n\r\n```hy\r\n(defn func [&key {\"a\" \"b\" \"c\" \"d\"}] (+ a c))\r\n```\r\n\r\nis the same thing as:\r\n\r\n```hy\r\n(defn func [&optional [a \"b\"] [c \"d\"]] (+ a c))\r\n```\r\n"}}