{"action":"created","issue":{"url":"https://api.github.com/repos/emberjs/guides/issues/91","labels_url":"https://api.github.com/repos/emberjs/guides/issues/91/labels{/name}","comments_url":"https://api.github.com/repos/emberjs/guides/issues/91/comments","events_url":"https://api.github.com/repos/emberjs/guides/issues/91/events","html_url":"https://github.com/emberjs/guides/issues/91","id":64418707,"number":91,"title":"Organization of Getting Started","user":{"login":"michaelrkn","id":1266530,"avatar_url":"https://avatars.githubusercontent.com/u/1266530?v=3","gravatar_id":"","url":"https://api.github.com/users/michaelrkn","html_url":"https://github.com/michaelrkn","followers_url":"https://api.github.com/users/michaelrkn/followers","following_url":"https://api.github.com/users/michaelrkn/following{/other_user}","gists_url":"https://api.github.com/users/michaelrkn/gists{/gist_id}","starred_url":"https://api.github.com/users/michaelrkn/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/michaelrkn/subscriptions","organizations_url":"https://api.github.com/users/michaelrkn/orgs","repos_url":"https://api.github.com/users/michaelrkn/repos","events_url":"https://api.github.com/users/michaelrkn/events{/privacy}","received_events_url":"https://api.github.com/users/michaelrkn/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":4,"created_at":"2015-03-26T02:16:30Z","updated_at":"2015-03-30T15:11:19Z","closed_at":null,"body":"I keep trying to begin adding info about getting started with Ember, especially Ember CLI, and then I keep feeling like I'm going to make a mess. So I'm taking a step back, proposing an outline of what should be covered and in what order, and asking for feedback and ideas.\r\n\r\n* Before You Start\r\n  * Welcome (currently `source/index.md`)\r\n  * Key Background Concepts (see #85)\r\n  * Core Ember Concepts (`/source/concepts/core-concepts.md`)\r\n  * Other Terms (`/source/ember-cli/glossary.md`)\r\n* Creating An Ember App\r\n  * Installing Ember (`source/ember-cli/index.md`)\r\n  * Ember New (move over from http://www.ember-cli.com/#folder-layout and combine `source/application/index.md`)\r\n  * Ember Server (needs to be written; explain asset compilation here; this would address item 2 of #31)\r\n  * Ember Build (needs to be written; explain more asset compilation, fingerprinting here)\r\n  * Windows (move over from http://www.ember-cli.com/#windows)\r\n\r\nI figure we can hold off on topics like add-ons and configuration until a later section.\r\n\r\nI also want to suggest breaking `concepts/concepts/naming-conventions.md` into pieces that are added to each of the relevant sections: for example, `concepts/naming-conventions/#toc_simple-routes` would be moved to `routing/naming-conventions`. An admirable goal of the guides is to \"to start from the basics, and slowly increase to more sophisticated concepts\", but naming conventions don't make any sense until you actually know what the thing is that you're naming.\r\n\r\nThoughts? Ideas? Suggestions?\r\n\r\nFor reference, the current structure looks like:\r\n\r\n* Getting Started\r\n  * Installing Ember\r\n  * Glossary\r\n* Getting Ember\r\n  * Getting Ember\r\n* Concepts\r\n  * Core Concepts\r\n  * Naming Conventions\r\n* Application\r\n  * Introduction\r\n\r\n[Leaving out _The Object Model_ which is stuck between _Concepts_ and _Application_.]"},"comment":{"url":"https://api.github.com/repos/emberjs/guides/issues/comments/87717425","html_url":"https://github.com/emberjs/guides/issues/91#issuecomment-87717425","issue_url":"https://api.github.com/repos/emberjs/guides/issues/91","id":87717425,"user":{"login":"michaelrkn","id":1266530,"avatar_url":"https://avatars.githubusercontent.com/u/1266530?v=3","gravatar_id":"","url":"https://api.github.com/users/michaelrkn","html_url":"https://github.com/michaelrkn","followers_url":"https://api.github.com/users/michaelrkn/followers","following_url":"https://api.github.com/users/michaelrkn/following{/other_user}","gists_url":"https://api.github.com/users/michaelrkn/gists{/gist_id}","starred_url":"https://api.github.com/users/michaelrkn/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/michaelrkn/subscriptions","organizations_url":"https://api.github.com/users/michaelrkn/orgs","repos_url":"https://api.github.com/users/michaelrkn/repos","events_url":"https://api.github.com/users/michaelrkn/events{/privacy}","received_events_url":"https://api.github.com/users/michaelrkn/received_events","type":"User","site_admin":false},"created_at":"2015-03-30T15:11:18Z","updated_at":"2015-03-30T15:11:18Z","body":"Also, to make it easier to review this, I've created an outline to show how I ended up organizing things, as they're slightly different from what I originally proposed above:\r\n\r\n* Before You Start\r\n  * Key Background Concepts (see #85)\r\n  * Core Concepts (from `/source/concepts/core-concepts.md`)\r\n  * Other Terms (from `/source/ember-cli/glossary.md`)\r\n  * Installing Ember (mostly from `source/ember-cli/index.md`; also includes http://www.ember-cli.com/#windows)\r\n* Ember CLI Basics\r\n  * Creating An App (mostly from http://www.ember-cli.com/#folder-layout, with `source/application/index.md` combined in)\r\n  * Running In Development (addresses item 2 of #31)\r\n  * Building For Production\r\n  * Naming Conventions (from `concepts/concepts/naming-conventions.md`)"}}