| 
									
										
										
										
											2016-10-05 15:48:55 -07:00
										 |  |  | block includes | 
					
						
							|  |  |  |   include ../_util-fns | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | :marked | 
					
						
							|  |  |  |   # Documentation Change Log | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   The Angular documentation is a living document with continuous improvements. | 
					
						
							|  |  |  |   This log calls attention to recent significant changes. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-10-21 22:31:09 +01:00
										 |  |  |   ## Sync with Angular v.2.1.1 (2016-10-21) | 
					
						
							|  |  |  |   Docs and code samples updated and tested with Angular v.2.1.0  | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-10-20 17:24:50 -07:00
										 |  |  |   ## npm _@types_ packages replace _typings_ (2016-10-20) | 
					
						
							|  |  |  |   Documentation samples now get TypeScript type information for 3rd party libraries | 
					
						
							|  |  |  |   from npm `@types` packages rather than with the _typings_ tooling. | 
					
						
							|  |  |  |   The `typings.json` file is gone. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   The "[Angular 1 Upgrade](upgrade.html)" guide reflects this change. | 
					
						
							|  |  |  |   The `package.json` installs `@types/angular` and several `@types/angular-...` | 
					
						
							|  |  |  |   packages in support of upgrade; these are not needed for pure Angular 2 development. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-10-20 10:56:17 -07:00
										 |  |  |   ## "Template Syntax" explains two-way data binding syntax (2016-10-20) | 
					
						
							|  |  |  |   Demonstrates how to two-way data bind to a custom Angular component and | 
					
						
							| 
									
										
										
										
											2016-10-20 19:28:19 -07:00
										 |  |  |   re-explains `[(ngModel)]` in terms of the basic `[()]` syntax. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   ## BREAKING CHANGE: `in-memory-web-api` (v.0.1.11) delivered as esm umd (2016-10-19) | 
					
						
							|  |  |  |   This change supports ES6 developers and aligns better with typical Angular libraries. | 
					
						
							|  |  |  |   It does not affect the module's API but it does affect how you load and import it. | 
					
						
							|  |  |  |   See the <a href="https://github.com/angular/in-memory-web-api/blob/master/CHANGELOG.md#0113-2016-10-20" target="_blank">change note</a> | 
					
						
							|  |  |  |   in the `in-memory-web-api` repo. | 
					
						
							| 
									
										
										
										
											2016-10-20 10:56:17 -07:00
										 |  |  | 
 | 
					
						
							|  |  |  |   ## "Router" _preload_ syntax and _:enter_/_:leave_ animations (2016-10-19) | 
					
						
							|  |  |  |   The router can lazily _preload_ modules _after_ the app starts and | 
					
						
							|  |  |  |   _before_ the user navigates to them for improved perceived performance. | 
					
						
							|  |  |  |    | 
					
						
							|  |  |  |   New `:enter` and `:leave` aliases make animation more natural.  | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-10-12 15:32:12 -07:00
										 |  |  |   ## Sync with Angular v.2.1.0 (2016-10-12) | 
					
						
							| 
									
										
										
										
											2016-10-12 15:29:28 -07:00
										 |  |  |   Docs and code samples updated and tested with Angular v.2.1.0  | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-10-12 04:44:49 -04:00
										 |  |  |   ## NEW "Ahead of Time (AoT) Compilation" cookbook (2016-10-11) | 
					
						
							|  |  |  |   The NEW [Ahead of Time (AoT) Compilation](../cookbook/aot-compiler.html) cookbook | 
					
						
							|  |  |  |   explains what AoT compilation is and why you'd want it. | 
					
						
							|  |  |  |   It demonstrates the basics with a QuickStart app | 
					
						
							|  |  |  |   followed by the more advanced considerations of compiling and bundling the Tour of Heroes. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-10-06 17:21:05 -07:00
										 |  |  |   ## Sync with Angular v.2.0.2 (2016-10-6) | 
					
						
							|  |  |  |   Docs and code samples updated and tested with Angular v.2.0.2  | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-10-05 15:48:55 -07:00
										 |  |  |   ## "Routing and Navigation" guide with the _Router Module_ (2016-10-5) | 
					
						
							|  |  |  |   The [Routing and Navigation](router.html) guide now locates route configuration | 
					
						
							|  |  |  |   in a _Routing Module_.  | 
					
						
							|  |  |  |   The _Routing Module_ replaces the previous _routing object_ involving the `ModuleWithProviders`. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   All guided samples with routing use the _Routing Module_ and prose content has been updated, | 
					
						
							|  |  |  |   most conspicuously in the  | 
					
						
							|  |  |  |   [NgModule](ngmodule.html) guide and [NgModule FAQ](../cookbook/ngmodule-faq.html) cookbook. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   ## New "Internationalization" Cookbook (2016-09-30) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   Added a new [Internationalization (i18n)](../cookbook/i18n.html) cookbook that shows how | 
					
						
							|  |  |  |   to use Angular "i18n" facilities to translate template text into multiple languages. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   ## "angular-in-memory-web-api" package rename (2016-09-27) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   Many samples use the `angular-in-memory-web-api` to simulate a remote server. | 
					
						
							|  |  |  |   This library is also useful to you during early development before you have a server to talk to. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   The package name was changed from "angular2-in-memory-web-api" which is still frozen-in-time on npm. | 
					
						
							|  |  |  |   The new "angular-in-memory-web-api" has new features.  | 
					
						
							|  |  |  |   <a href="https://github.com/angular/in-memory-web-api/blob/master/README.md" target="_blank">Read about them on github</a>. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   ## "Style Guide" with _NgModules_ (2016-09-27) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   [StyleGuide](style-guide.html) explains our recommended conventions for Angular modules (NgModule). | 
					
						
							|  |  |  |   Barrels now are far less useful and have been removed from the style guide; | 
					
						
							|  |  |  |   they remain valuable but are not a matter of Angular style. | 
					
						
							|  |  |  |   We also relaxed the rule that discouraged use of the `@Component.host` property. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   ## _moduleId: module.id_ everywhere (2016-09-25) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   Sample components that get their templates or styles with `templateUrl` or `styleUrls` | 
					
						
							|  |  |  |   have been converted to _module-relative_ URLs. | 
					
						
							|  |  |  |   We added the `moduleId: module.id` property-and-value to their `@Component` metadata. | 
					
						
							|  |  |  |    | 
					
						
							|  |  |  |   This change is a requirement for compilation with AoT compiler when the app loads | 
					
						
							|  |  |  |   modules with SystemJS as the samples currently do. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   ## "Lifecycle Hooks" guide simplified (2016-09-24) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   The [Lifecycle Hooks](lifecycle-hooks.html) guide is shorter, simpler, and  | 
					
						
							|  |  |  |   draws more attention to the order in which Angular calls the hooks. |