From 8ca208ff59eb15c8273c9017a796538cfa1934b3 Mon Sep 17 00:00:00 2001 From: jenniferfell Date: Tue, 25 Sep 2018 10:16:51 -0600 Subject: [PATCH] docs: remove outdated docs change log (#26102) PR Close #26102 --- aio/content/guide/change-log.md | 221 ------------------ aio/content/navigation.json | 6 - aio/firebase.json | 3 +- aio/ngsw-config.json | 1 + .../deployment/shared/URLS_TO_REDIRECT.txt | 4 +- 5 files changed, 5 insertions(+), 230 deletions(-) delete mode 100644 aio/content/guide/change-log.md diff --git a/aio/content/guide/change-log.md b/aio/content/guide/change-log.md deleted file mode 100644 index 2818161737..0000000000 --- a/aio/content/guide/change-log.md +++ /dev/null @@ -1,221 +0,0 @@ -# Change Log - - - -The Angular documentation is a living document with continuous improvements. -This log calls attention to recent significant changes. - -## Updated to Angular 4.0. Documentation for Angular 2.x can be found at [v2.angular.io](https://v2.angular.io). - -## All mention of moduleId removed. "Component relative paths" guide deleted (2017-03-13) -We added a new SystemJS plugin (systemjs-angular-loader.js) to our recommended SystemJS configuration. -This plugin dynamically converts "component-relative" paths in templateUrl and styleUrls to "absolute paths" for you. - -We strongly encourage you to only write component-relative paths. -That is the only form of URL discussed in these docs. You no longer need to write @Component({ moduleId: module.id }), nor should you. - -## NEW: Downloadable examples for each guide (2017-02-28) -Now you can download the sample code for any guide and run it locally. -Look for the new download links next to the "live example" links. - -## Template Syntax/Structural Directives: refreshed (2017-02-06) -The [_Template-Syntax_](guide/template-syntax) and [_Structural Directives_](guide/structural-directives) -guides were significantly revised for clarity, accuracy, and current recommended practices. -Discusses ``. -Revised samples are more clear and cover all topics discussed. - -## NEW: Samples re-structured with `src/` folder (2017-02-02) -All documentation samples have been realigned with the default folder structure of the Angular CLI. -That's a step along the road to basing the sample in the Angular CLI. -But it's also good in its own right. -It helps clearly separate app code from setup and configuration files. - -All samples now have a `src/` folder at the project root. -The former `app/` folder moves under `src/`. -Read about moving your existing project to this structure in - -the QuickStart repo update instructions. - -Notably: - -* `app/main.ts` moved to `src/main.ts`. -* `app/` moved to `src/app/`. -* `index.html`, `styles.css` and `tsconfig.json` moved inside `src/`. -* `systemjs.config.js` now imports `main.js` instead of `app`. -* Added `lite-server` configuration (`bs-config.json`) to serve `src/`. - -## NEW: Reactive Forms guide (2017-01-31) -The new [**Reactive Forms**](guide/reactive-forms) guide explains how and why to build a "reactive form". -"Reactive Forms" are the code-based counterpart to the declarative "Template Driven" forms approach -introduced in the [Forms](guide/forms) guide. -Check it out before you decide how to add forms to your app. -Remember also that you can use both techniques in the same app, -choosing the approach that best fits each scenario. - -## NEW: Deployment guide (2017-01-30) - -The new [Deployment](guide/deployment) guide describes techniques for putting your application on a server. -It includes important advice on optimizing for production. - -## Hierarchical Dependency Injection: refreshed (2017-01-13) - -[Hierarchical Dependency Injection](guide/hierarchical-dependency-injection) guide is significantly revised. -Closes issue #3086. -Revised samples are clearer and cover all topics discussed. - -## Miscellaneous (2017-01-05) - -* [Setup](guide/setup) guide: -added (optional) instructions on how to remove _non-essential_ files. -* No longer consolidate RxJS operator imports in `rxjs-extensions` file; each file should import what it needs. -* All samples prepend template/style URLs with `./` as a best practice. -* [Style Guide](guide/styleguide): copy edits and revised rules. - -## Router: more detail (2016-12-21) - -Added more information to the [Router](guide/router) guide -including sections named outlets, wildcard routes, and preload strategies. - -## HTTP: how to set default request headers (and other request options) (2016-12-14) - -Added section on how to set default request headers (and other request options) to -HTTP guide. - -## Testing: added component test plunkers (2016-12-02) - -Added two plunkers that each test _one simple component_ so you can write a component test plunker of your own: one for the QuickStart seed's `AppComponent` and another for the Testing guide's `BannerComponent`. -Linked to these plunkers in "Testing" and "Setup anatomy" guides. - -## Internationalization: pluralization and _select_ (2016-11-30) - -The [Internationalization (i18n)](guide/i18n) guide explains how to handle pluralization and -translation of alternative texts with `select`. -The sample demonstrates these features too. - -## Testing: karma file updates (2016-11-30) - -* `karma.config` + `karma-test-shim` can handle multiple spec source paths; -see quickstart issue: [angular/quickstart#294](https://github.com/angular/quickstart/issues/294). -* Displays Jasmine Runner output in the karma-launched browser. - -## QuickStart Rewrite (2016-11-18) - -The QuickStart is completely rewritten so that it actually is quick. -It references a minimal "Hello Angular" app running in Plunker. -The new [Setup](guide/setup) page tells you how to install a local development environment -by downloading (or cloning) the QuickStart github repository. -You are no longer asked to copy-and-paste code into setup files that were not explained anyway. - -## Sync with Angular v.2.2.0 (2016-11-14) - -Docs and code samples updated and tested with Angular v.2.2.0. - -## UPDATE: NgUpgrade Guide for the AOT friendly _upgrade/static_ module (2016-11-14) - -The updated [NgUpgrade Guide](guide/upgrade) guide covers the -new AOT friendly `upgrade/static` module -released in v.2.2.0, which is the recommended -facility for migrating from AngularJS to Angular. -The documentation for the version prior to v.2.2.0 has been removed. - -## ES6 described in "TypeScript to JavaScript" (2016-11-14) - -The updated TypeScript to JavaScript guide explains how to write apps in ES6/7 -by translating the common idioms in the TypeScript documentation examples -(and elsewhere on the web) to ES6/7 and ES5. - -This was [removed in August 2017](https://github.com/angular/angular/pull/18694) but can still be -viewed in the [v2 documentation](https://v2.angular.io/docs/ts/latest/cookbook/ts-to-js.html). - -## Sync with Angular v.2.1.1 (2016-10-21) - -Docs and code samples updated and tested with Angular v.2.1.1. - -## 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 [AngularJS Upgrade](guide/upgrade) 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 development. - -## "Template Syntax" explains two-way data binding syntax (2016-10-20) - -Demonstrates how to two-way data bind to a custom Angular component and -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 change note -in the `in-memory-web-api` repo. - -## "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. - -## Sync with Angular v.2.1.0 (2016-10-12) - -Docs and code samples updated and tested with Angular v.2.1.0. - -## NEW "Ahead of time (AOT) Compilation" guide (2016-10-11) - -The NEW [Ahead of time (AOT) Compilation](guide/aot-compiler) guide -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. - -## Sync with Angular v.2.0.2 (2016-10-6) - -Docs and code samples updated and tested with Angular v.2.0.2. - -## "Routing and Navigation" guide with the _Router Module_ (2016-10-5) - -The [Routing and Navigation](guide/router) 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](guide/ngmodules) guide and [NgModule FAQ](guide/ngmodule-faq) guide. - -## New "Internationalization" guide (2016-09-30) - -Added a new [Internationalization (i18n)](guide/i18n) guide 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. -Read about them on github. - -## "Style Guide" with _NgModules_ (2016-09-27) - -[StyleGuide](guide/styleguide) explains recommended conventions for NgModules. -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. -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. -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](guide/lifecycle-hooks) guide is shorter, simpler, and -draws more attention to the order in which Angular calls the hooks. diff --git a/aio/content/navigation.json b/aio/content/navigation.json index 17736beef8..901be10eb5 100644 --- a/aio/content/navigation.json +++ b/aio/content/navigation.json @@ -708,12 +708,6 @@ "title": "API", "tooltip": "Details of the Angular packages, classes, interfaces, and other types.", "url": "api" - }, - { - "url": "guide/change-log", - "title": "Change Log", - "tooltip": "Angular Documentation Change Log", - "hidden": true } ], "Footer": [ diff --git a/aio/firebase.json b/aio/firebase.json index 683e3ea9dd..17de0fe137 100644 --- a/aio/firebase.json +++ b/aio/firebase.json @@ -27,6 +27,7 @@ {"type": 301, "source": "/guide/service-worker-configref", "destination": "/guide/service-worker-config"}, {"type": 301, "source": "/guide/webpack", "destination": "https://v5.angular.io/guide/webpack"}, {"type": 301, "source": "/guide/setup-systemjs-anatomy", "destination": "/guide/file-structure"}, + {"type": 301, "source": "/guide/change-log", "destination": "https://github.com/angular/angular/blob/master/CHANGELOG.md"}, // some top level guide pages on old site were moved below the guide folder {"type": 301, "source": "/styleguide", "destination": "/guide/styleguide"}, @@ -39,7 +40,7 @@ {"type": 301, "source": "/docs/*/latest/cookbook", "destination": "/docs"}, {"type": 301, "source": "/docs/*/latest/cookbook/", "destination": "/docs"}, {"type": 301, "source": "/docs/*/latest/cookbook/index.html", "destination": "/docs"}, - {"type": 301, "source": "/**/cookbook/ts-to-js*", "destination": "https://github.com/angular/angular/blob/master/aio/content/guide/change-log.md#es6--described-in-typescript-to-javascript-2016-11-14"}, + {"type": 301, "source": "/**/cookbook/ts-to-js*", "destination": "https://v2.angular.io/docs/ts/latest/cookbook/ts-to-js.html"}, {"type": 301, "source": "/docs/*/latest/cookbook/a1-a2-quick-reference.html", "destination": "/guide/ajs-quick-reference"}, {"type": 301, "source": "/docs/*/latest/cookbook/component-communication.html", "destination": "/guide/component-interaction"}, {"type": 301, "source": "/docs/*/latest/cookbook/dependency-injection.html", "destination": "/guide/dependency-injection-in-action"}, diff --git a/aio/ngsw-config.json b/aio/ngsw-config.json index 2178ba8815..4e482e7814 100644 --- a/aio/ngsw-config.json +++ b/aio/ngsw-config.json @@ -91,6 +91,7 @@ "!/api/testing/**", "!/docs/?*", "!/docs/*/**", + "!/guide/change-log", "!/guide/cli-quickstart", "!/guide/cli-quickstart.html", "!/guide/cli-quickstart/", diff --git a/aio/tests/deployment/shared/URLS_TO_REDIRECT.txt b/aio/tests/deployment/shared/URLS_TO_REDIRECT.txt index e81bc5e706..5a0cf9d9c9 100644 --- a/aio/tests/deployment/shared/URLS_TO_REDIRECT.txt +++ b/aio/tests/deployment/shared/URLS_TO_REDIRECT.txt @@ -145,7 +145,7 @@ /docs/js/latest/api/upgrade/index/UpgradeAdapter-class.html /api/upgrade/UpgradeAdapter /docs/js/latest/api/upgrade/static/UpgradeModule-class /api/upgrade/static/UpgradeModule /docs/js/latest/api/upgrade/static/UpgradeModule-class.html /api/upgrade/static/UpgradeModule -/docs/js/latest/cookbook/ts-to-js.html https://github.com/angular/angular/blob/master/aio/content/guide/change-log.md#es6--described-in-typescript-to-javascript-2016-11-14 +/docs/js/latest/cookbook/ts-to-js.html https://v2.angular.io/docs/ts/latest/cookbook/ts-to-js.html /docs/js/latest/glossary /guide/glossary /docs/js/latest/guide/ /docs /docs/js/latest/guide/lifecycle-hooks /guide/lifecycle-hooks @@ -170,7 +170,7 @@ /docs/ts/latest/api/http/testing/index/MockConnection-class.html /api/http/testing/MockConnection /docs/ts/latest/api/platform-browser-dynamic/index/workerAppDynamicPlatform-let.html /api/platform-browser-dynamic/workerAppDynamicPlatform /docs/ts/latest/api/testing/fakeAsync-function.html /api/core/testing/fakeAsync -/docs/ts/latest/cookbook/ts-to-js.html https://github.com/angular/angular/blob/master/aio/content/guide/change-log.md#es6--described-in-typescript-to-javascript-2016-11-14 +/docs/ts/latest/cookbook/ts-to-js.html https://v2.angular.io/docs/ts/latest/cookbook/ts-to-js.html /guide/cli-quickstart /guide/quickstart /guide/learning-angular /guide/quickstart /guide/learning-angular.html /guide/quickstart