{"action":"opened","issue":{"url":"https://api.github.com/repos/hylang/hy-style-guide/issues/4","repository_url":"https://api.github.com/repos/hylang/hy-style-guide","labels_url":"https://api.github.com/repos/hylang/hy-style-guide/issues/4/labels{/name}","comments_url":"https://api.github.com/repos/hylang/hy-style-guide/issues/4/comments","events_url":"https://api.github.com/repos/hylang/hy-style-guide/issues/4/events","html_url":"https://github.com/hylang/hy-style-guide/issues/4","id":154543153,"number":4,"title":"Explain indentation rules better.","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":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2016-05-12T17:55:13Z","updated_at":"2016-05-12T17:55:13Z","closed_at":null,"body":"The guide says\r\n> Indentation shall be 2 spaces (no hard tabs), except when matching the indentation of the previous line.\r\n\r\nBut later on in this document, why is `with` consistently indented by 4 spaces instead?\r\n```Hy\r\n;; good:\r\n(with [fd (open \"/etc/passwd\")]\r\n    (print (.readlines fd)))\r\n```\r\nIf there are exceptions, they should be stated, otherwise the examples in the style guide of good style should actually, you know, follow the style guide.\r\n\r\nI also think Lisp-style indentation where you align with the first argument on the same line as the operator like\r\n```Hy\r\n(+ (* b c)\r\n   (* d e)\r\n   (/ f g))\r\n```\r\nshould be permissible. The style guide should either say so, or explicitly reject this style, like so:\r\n```Hy\r\n;; good (acceptable?)\r\n(+\r\n  (* b c)\r\n  (* d e)\r\n  (/ f g))\r\n;; bad (good?)\r\n(+ (* b c)\r\n   (* d e)\r\n   (/ f g))\r\n```"}}