{"action":"closed","issue":{"url":"https://api.github.com/repos/angular/angular.io/issues/194","labels_url":"https://api.github.com/repos/angular/angular.io/issues/194/labels{/name}","comments_url":"https://api.github.com/repos/angular/angular.io/issues/194/comments","events_url":"https://api.github.com/repos/angular/angular.io/issues/194/events","html_url":"https://github.com/angular/angular.io/issues/194","id":102414783,"number":194,"title":"Update documentation to use angular35","user":{"login":"ericmartinezr","id":13039652,"avatar_url":"https://avatars.githubusercontent.com/u/13039652?v=3","gravatar_id":"","url":"https://api.github.com/users/ericmartinezr","html_url":"https://github.com/ericmartinezr","followers_url":"https://api.github.com/users/ericmartinezr/followers","following_url":"https://api.github.com/users/ericmartinezr/following{/other_user}","gists_url":"https://api.github.com/users/ericmartinezr/gists{/gist_id}","starred_url":"https://api.github.com/users/ericmartinezr/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ericmartinezr/subscriptions","organizations_url":"https://api.github.com/users/ericmartinezr/orgs","repos_url":"https://api.github.com/users/ericmartinezr/repos","events_url":"https://api.github.com/users/ericmartinezr/events{/privacy}","received_events_url":"https://api.github.com/users/ericmartinezr/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2015-08-21T16:25:35Z","updated_at":"2015-08-25T21:52:15Z","closed_at":"2015-08-25T21:52:15Z","body":"Both 5 min quickstart and step by step guide are too outdated. They even use differents version (alpha28 and alpha26 respectively).\r\n\r\nSo my suggestions are :\r\n\r\n- Change in both cases every outdated reference to the last one so far (alpha35). Consider that, for example, [DirectiveAnnotation](https://angular.io/docs/js/latest/api/annotations/DirectiveAnnotation-class.html) references `@Host()` that was introduced in alpha34, so there's no chance that the examples in API Review works with 5 min quickstart nor step by step guide.\r\n- Following the first point, DirectiveAnnotation was renamed to DirectiveMetadata (same with everything that ends with 'Annotation') and the category in the website should be renamed to 'Metadata' as well (for those using `sfx` bundle and ES5).\r\n\r\nBreaking down the changes needed \r\n\r\n**5 min quickstart**\r\n\r\n- Considering that from alpha35 using `npm` we have all the typings and javascript files, we could add the following\r\n ```\r\n$ npm install -g angular2@2.0.0-alpha-35 tsd@^0.6.0\r\n$ tsd install angular2 es6-promise rx rx-lite\r\n```\r\nI wouldn't remove it from `tsd` since the paths where everything is installed are different between `npm` and `tsd`. So I would add in the documentation to copy the typings downloaded by `npm` to the typings folder created by `tsd` (until http.d.ts is added to the DefinitelyTyped repo. The examples of TypeScript points to `typings/angular2/angular2.d.ts` while with `npm` the typings are under `node_modules/angular2/bundles/typings/*`).\r\n\r\n- Change `https://code.angularjs.org/2.0.0-alpha.28/angular2.dev.js` to `https://code.angularjs.org/2.0.0-alpha.35/angular2.dev.js`\r\n\r\n**Step by step guide**\r\n\r\n1.- Getting started\r\n- Change every reference of alpha26 to alpha35 (typescript and ES5)\r\n- `window.angular` was changed to `window.ng`\r\n\r\n2.- Displaying data\r\n- The biggest issue I see here is the ordering of the classes in the example. That wouldn't work because `FriendsService` is declared after `DisplayComponent`. `FriendsService` should be moved above `DisplayComponent` and explains why the order and make reference to `forwardRef` so the user knows what's going on.\r\n\r\n3.- User input\r\n- There are already fixes to the typos, so I'm skipping it. \r\n- In the ES5 examples change `*Annotation` to `*Metadata` and `new angular.*` to `new ng.*`\r\n- Change `angular.bootstrap` to `ng.bootstrap`\r\n\r\n4.- Making components\r\n- Same issue that in **Displaying Data**, the order of the classes will make it fail. \r\n- Same as 2nd point in **User Input**\r\n\r\nI decided to write this, since there are [users](http://stackoverflow.com/questions/32118684/ng-model-in-regular-es5-angular-2-0) still using alpha26.\r\n\r\nThis is what I have in mind. Any feedback? Any suggestions? What do you think?"}}