{"action":"created","issue":{"url":"https://api.github.com/repos/tedconf/code-style-guides/issues/19","labels_url":"https://api.github.com/repos/tedconf/code-style-guides/issues/19/labels{/name}","comments_url":"https://api.github.com/repos/tedconf/code-style-guides/issues/19/comments","events_url":"https://api.github.com/repos/tedconf/code-style-guides/issues/19/events","html_url":"https://github.com/tedconf/code-style-guides/issues/19","id":117656794,"number":19,"title":"Style guide structure & formatting","user":{"login":"redoPop","id":109632,"avatar_url":"https://avatars.githubusercontent.com/u/109632?v=3","gravatar_id":"","url":"https://api.github.com/users/redoPop","html_url":"https://github.com/redoPop","followers_url":"https://api.github.com/users/redoPop/followers","following_url":"https://api.github.com/users/redoPop/following{/other_user}","gists_url":"https://api.github.com/users/redoPop/gists{/gist_id}","starred_url":"https://api.github.com/users/redoPop/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/redoPop/subscriptions","organizations_url":"https://api.github.com/users/redoPop/orgs","repos_url":"https://api.github.com/users/redoPop/repos","events_url":"https://api.github.com/users/redoPop/events{/privacy}","received_events_url":"https://api.github.com/users/redoPop/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/tedconf/code-style-guides/labels/meta","name":"meta","color":"131313"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":8,"created_at":"2015-11-18T19:03:13Z","updated_at":"2015-11-30T20:45:04Z","closed_at":null,"body":"Until now, this Code Style Guides repo [has been a collection of flat markdown files](https://github.com/tedconf/code-style-guides/tree/2207b126a7074153e56a0aa681f2ffac0a45b17e):\r\n\r\n![1-old-busted](https://cloud.githubusercontent.com/assets/109632/11251404/b5646b28-8df6-11e5-99c4-5282a0ad48b1.png)\r\n\r\nb3a2875dfe6a19beaf74ee5f3763ac1e11fe7f6d experiments with making it a fully structured Ember app [with its own site](http://tedconf.github.io/code-style-guides/):\r\n\r\n![2-new-hotness](https://cloud.githubusercontent.com/assets/109632/11251406/b8777076-8df6-11e5-8e34-eb148e89defd.png)\r\n\r\nThis change results in the style guide documents themselves using the structure of an Ember app (i.e. [they are stored as templates within pods](https://github.com/tedconf/code-style-guides/blob/40078c70d245a3636f95341752bc8d97ac5251bf/app/pods/ruby/rspec/template.md)).\r\n\r\nThis issue exists to discuss the pros & cons of this layout and rendering, and decide which of those factors weigh more strongly for us as a team."},"comment":{"url":"https://api.github.com/repos/tedconf/code-style-guides/issues/comments/160756313","html_url":"https://github.com/tedconf/code-style-guides/issues/19#issuecomment-160756313","issue_url":"https://api.github.com/repos/tedconf/code-style-guides/issues/19","id":160756313,"user":{"login":"samselikoff","id":2922250,"avatar_url":"https://avatars.githubusercontent.com/u/2922250?v=3","gravatar_id":"","url":"https://api.github.com/users/samselikoff","html_url":"https://github.com/samselikoff","followers_url":"https://api.github.com/users/samselikoff/followers","following_url":"https://api.github.com/users/samselikoff/following{/other_user}","gists_url":"https://api.github.com/users/samselikoff/gists{/gist_id}","starred_url":"https://api.github.com/users/samselikoff/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/samselikoff/subscriptions","organizations_url":"https://api.github.com/users/samselikoff/orgs","repos_url":"https://api.github.com/users/samselikoff/repos","events_url":"https://api.github.com/users/samselikoff/events{/privacy}","received_events_url":"https://api.github.com/users/samselikoff/received_events","type":"User","site_admin":false},"created_at":"2015-11-30T20:45:04Z","updated_at":"2015-11-30T20:45:04Z","body":"I agree that this issue should be iced if we're not on the same page about what problem code-style-guides is solving.\r\n\r\nMy take is that we currently have no place to put and share common code styles, heuristics, conventions, patterns, etc. that go *beyond* jshint and rubocop (the kinds of things in the markdown files as of 2207b126a7074153e56a0aa681f2ffac0a45b17e), and that we need such a place, and that code-style-guides was that place. If we're not all in agreement here, I guess we need to discuss.\r\n\r\nOne more thought, perhaps we could make a separate place for Ember guides, so we can experiment there, and not have to make this a big thing that involves everybody?\r\n\r\nOne last thought, I'd prefer some tinkering to more extended discussion, I feel like we'll all agree on a solution once we *see* it and *feel* it. The Ember app was my tinkering bc it seemed code-style-guides was not being unused. Maybe I could just move it to a separate repo and mess around myself, perhaps keep it to Ember guides, and we could see how it feels, and show it to Dan/Grady etc.? That way we'll start getting actual feedback as quickly as possible, instead of theorizing about what will or will not work.\r\n\r\nOkay bed time because I'm still in :camel:"}}