{"action":"created","issue":{"url":"https://api.github.com/repos/donejs/javascriptmvc/issues/67","labels_url":"https://api.github.com/repos/donejs/javascriptmvc/issues/67/labels{/name}","comments_url":"https://api.github.com/repos/donejs/javascriptmvc/issues/67/comments","events_url":"https://api.github.com/repos/donejs/javascriptmvc/issues/67/events","html_url":"https://github.com/donejs/javascriptmvc/issues/67","id":110383746,"number":67,"title":"Getting Started Guide Notes","user":{"login":"alexisabril","id":84209,"avatar_url":"https://avatars.githubusercontent.com/u/84209?v=3","gravatar_id":"","url":"https://api.github.com/users/alexisabril","html_url":"https://github.com/alexisabril","followers_url":"https://api.github.com/users/alexisabril/followers","following_url":"https://api.github.com/users/alexisabril/following{/other_user}","gists_url":"https://api.github.com/users/alexisabril/gists{/gist_id}","starred_url":"https://api.github.com/users/alexisabril/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/alexisabril/subscriptions","organizations_url":"https://api.github.com/users/alexisabril/orgs","repos_url":"https://api.github.com/users/alexisabril/repos","events_url":"https://api.github.com/users/alexisabril/events{/privacy}","received_events_url":"https://api.github.com/users/alexisabril/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":17,"created_at":"2015-10-08T06:46:12Z","updated_at":"2015-10-08T06:46:27Z","closed_at":null,"body":"_Issue by **[justinbmeyer](https://github.com/justinbmeyer)** from Sunday Aug 09, 2015 at 21:40 GMT_\n_Originally opened as https://github.com/donejs/donejs/issues/30_\n\n----\n\n# Closed Issues\r\n\r\n* changing less breaks live-reload: https://github.com/donejs/donejs/issues/31\r\n* changed AppState to AppViewModel: https://github.com/donejs/donejs/issues/32\r\n* warn about route changes needing a server restart: https://github.com/donejs/donejs/pull/34\r\n\r\n# Setup the project\r\n\r\n- [x] space before folder name\r\n\r\n```\r\nCreating folder  place-my-order\r\nInstalling yeoman-environment\r\n```\r\n\r\n- [x] __Remove short name from generator (p0)__\r\n\r\nI thought we already did this.  But we should certainly remove this before launch.  We should have people enter in their component's module and tag name when creating a component.\r\n\r\n\r\n- [ ] __On a high level, what does the generator do?__\r\n\r\nI think this section can be improved. I think things are installed first, and then the questions come ... couldn't hurt to present the guide that way.\r\n\r\n- [ ] __Testee or Karma - Test runner__\r\n\r\nIsn't Testee installed only at this point?  We should probably remove Karma for now.\r\n\r\n- [ ] __Key your keywords (comma to split) (p3)__\r\n\r\nThis is phrased weird and doesn't have a colon (:) after it like all the other questions do. Issue #58 \r\n\r\n- [ ] __The other questions can be skipped for now by hitting enter.__\r\n\r\n\r\nThe \"src\" folder MUST be skipped to pick their defaults right?  The other ones can be skipped.\r\n\r\n\r\n- [ ] __we can see the following files:__\r\n\r\nIt might be better if we have the descriptions next to the source.  If not, at least in the section below, the `file` should be separated from the description with a hyphen.\r\n\r\n- [x] __You can start both by running: donejs develp (p3)__\r\n\r\nThe user won't be within place-my-order at this point.  Should `donejs init` leave them there?  If not, we should tell them to `cd` into that folder.\r\n\r\n- [ ] __Use testee to open dev page. (p3)__ #19\r\n\r\nCan we use `testee` to open this page for them?  That way they don't have to navigate there?\r\n\r\n- [ ] __Nice warning /error if `npm start` fails. (p4)__ #63.\r\n\r\nI had another process on 8080.  A better error message would be nice. \r\n\r\n- [ ] __Warnings about asset helper:__ #19\r\n\r\n<img width=\"562\" alt=\"cursor_and_place-my-order\" src=\"https://cloud.githubusercontent.com/assets/78602/9157158/6c0fc432-3eb8-11e5-91f7-de490b98acce.png\">\r\n\r\n\r\n- [ ] __Try it by changing the message property in src/app.js. (p3)__\r\n\r\nTo what?  What should they expect?  A video or something would be good here.  Maybe they should change the styles too?\r\n\r\n- [ ] __place-my-order@0.0.0 No README data (p3)__ #64\r\n\r\nWe should generate a README with the basic commands used to develop the app / test / deploy / build / etc.\r\n\r\n## Setup a service API\r\n\r\n- [ ] __npm install place-my-order-api --save__\r\n\r\nShould they do this in another console? To leave up the live-reload?\r\n\r\n## Loading assets\r\n\r\n- [ ] __Before we create the first files we also need to install the place-my-order-assets__\r\n\r\nThis is worded strangely.  First files?  We are really installing them and then loading them into our application.  We should let people know we don't want to bore them with creating the app's CSS.\r\n\r\n- [ ] __Every DoneJS application consists of at least two files:__\r\n\r\nI think this discussion should be put in the __Development mode__ section.  That section already references these two concepts and asks people to change them.  I'd put something the following in development mode:\r\n\r\n-----\r\n\r\nBefore we move on, lets take a look at what we've setup.  First, open `src/index.stache`, this is the entry-point of your application. This is what is rendered on the server.  If you check your network tab you'll see `localhost:8080` sent back something like this:\r\n\r\n```\r\n<!doctype ....>\r\n```\r\n\r\nThis template is also used to update the page when the template's data changes.\r\n\r\nEvery template needs data to render right?  The `src/app.js` file defines the data `src/index.stache` uses to render.  Go ahead and change the message property from `'Hello World!'` to `'Hello There!`.  Notice that your page changed automatically.\r\n\r\nThe data the template uses to render is called the template's `viewModel`.  `index.stache` imports its own view model with:\r\n\r\n```\r\n<can-import from=\"place-my-order/app\" as=\"viewModel\" />\r\n```\r\n\r\nThis is why it can render the application viewModel's message with:\r\n\r\n```\r\n<h1>{{message}}</h1>\r\n```\r\n\r\nMost of the other lines of this template help setup dependency management. We will talk about this later.\r\n\r\n-----\r\n\r\nWith that gone, you can simply say to load those styles into the application, you just have to import them by adding:\r\n\r\n```\r\n<can-import from=\"place-my-order-assets\" />\r\n```\r\n\r\n- [ ] __the main application file at src/app.js looks like this:__\r\n\r\nIt should also include the title property.  Should we rename AppState to `AppViewModel`?\r\n\r\n\r\n- [x] __Adding place-my-order-assets errors: (p0)__\r\n\r\nwhen I install it, I see:\r\n\r\n<img width=\"1013\" alt=\"place-my-order_ _bash_ _80x24_and_place-my-order_and_justin_ _bash_ _80x24\" src=\"https://cloud.githubusercontent.com/assets/78602/9157362/5e507d84-3ec0-11e5-9d2b-49d662b30381.png\">\r\n\r\n## Starting the application\r\n\r\n- [ ] __Now our application is good to go and we can start the server__\r\n\r\nIt's not really good to go and we had already started it.\r\n\r\n- [ ] __We need to proxy the place-my-order-api server to /api__\r\n\r\nAren't we proxying `/api` to `place-my-order-api`?\r\n\r\n- [ ] __scripti__\n"},"comment":{"url":"https://api.github.com/repos/donejs/javascriptmvc/issues/comments/146435270","html_url":"https://github.com/donejs/javascriptmvc/issues/67#issuecomment-146435270","issue_url":"https://api.github.com/repos/donejs/javascriptmvc/issues/67","id":146435270,"user":{"login":"alexisabril","id":84209,"avatar_url":"https://avatars.githubusercontent.com/u/84209?v=3","gravatar_id":"","url":"https://api.github.com/users/alexisabril","html_url":"https://github.com/alexisabril","followers_url":"https://api.github.com/users/alexisabril/followers","following_url":"https://api.github.com/users/alexisabril/following{/other_user}","gists_url":"https://api.github.com/users/alexisabril/gists{/gist_id}","starred_url":"https://api.github.com/users/alexisabril/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/alexisabril/subscriptions","organizations_url":"https://api.github.com/users/alexisabril/orgs","repos_url":"https://api.github.com/users/alexisabril/repos","events_url":"https://api.github.com/users/alexisabril/events{/privacy}","received_events_url":"https://api.github.com/users/alexisabril/received_events","type":"User","site_admin":false},"created_at":"2015-10-08T06:46:27Z","updated_at":"2015-10-08T06:46:27Z","body":"_Comment by **[daffl](https://github.com/daffl)** from Wednesday Aug 12, 2015 at 15:19 GMT_\n\n----\n\nAlso, @alexisabril's `TypeError: undefined is not a function` error issue should be fixed now in the generator.\n"}}