mirror of
https://github.com/angular/angular.git
synced 2026-09-14 13:54:52 +08:00
docs: update outdated and broken external links in adev
Several external links pointed at locations that have moved or gone away:
- ng-packagr, webpack, and node-glob renamed their default branch from
master to main, so the deep links into those repos redirect.
- The npm package pages moved from npmjs.org to www.npmjs.com.
- The Angular Material and CDK docs moved from material.angular.io to
material.angular.dev.
- The semver reference pointed at the defunct semver.io service; point it
at the SemVer spec at semver.org instead.
- The MDN animationiteration event link had a typo (animationitration).
- compiler-cli's metadata/schema.ts was removed after v12; pin the link to
the 12.2.x tag where the file still exists.
- The angularindepth.com article is gone (its domain is parked); link to its
live home on the Angular In Depth Medium publication.
- Google moved the Lighthouse user-timing docs to developer.chrome.com.
Point the links at their current, working locations.
(cherry picked from commit 058c7f9b0c)
This commit is contained in:
Kam
@@ -708,7 +708,7 @@ export const RECOMMENDATIONS: Step[] = [
|
||||
level: ApplicationComplexity.Advanced,
|
||||
step: 'wtf',
|
||||
action:
|
||||
'Support for web tracing framework in Angular was deprecated in version 8. You should stop using any of the `wtf*` APIs. To do performance tracing, we recommend using [browser performance tools](https://developers.google.com/web/tools/lighthouse/audits/user-timing).',
|
||||
'Support for web tracing framework in Angular was deprecated in version 8. You should stop using any of the `wtf*` APIs. To do performance tracing, we recommend using [browser performance tools](https://developer.chrome.com/docs/lighthouse/performance/user-timings).',
|
||||
},
|
||||
{
|
||||
possibleIn: 800,
|
||||
|
||||
@@ -127,7 +127,7 @@ If you have actions you would like to execute at certain points during animation
|
||||
|
||||
[`OnAnimationStart`](https://developer.mozilla.org/en-US/docs/Web/API/Element/animationstart_event)
|
||||
[`OnAnimationEnd`](https://developer.mozilla.org/en-US/docs/Web/API/Element/animationend_event)
|
||||
[`OnAnimationIteration`](https://developer.mozilla.org/en-US/docs/Web/API/Element/animationitration_event)
|
||||
[`OnAnimationIteration`](https://developer.mozilla.org/en-US/docs/Web/API/Element/animationiteration_event)
|
||||
[`OnAnimationCancel`](https://developer.mozilla.org/en-US/docs/Web/API/Element/animationcancel_event)
|
||||
|
||||
[`OnTransitionStart`](https://developer.mozilla.org/en-US/docs/Web/API/Element/transitionstart_event)
|
||||
|
||||
@@ -193,7 +193,7 @@ The animations package exposed callbacks for you to use in the case that you wan
|
||||
|
||||
[`OnAnimationStart`](https://developer.mozilla.org/en-US/docs/Web/API/Element/animationstart_event)
|
||||
[`OnAnimationEnd`](https://developer.mozilla.org/en-US/docs/Web/API/Element/animationend_event)
|
||||
[`OnAnimationIteration`](https://developer.mozilla.org/en-US/docs/Web/API/Element/animationitration_event)
|
||||
[`OnAnimationIteration`](https://developer.mozilla.org/en-US/docs/Web/API/Element/animationiteration_event)
|
||||
[`OnAnimationCancel`](https://developer.mozilla.org/en-US/docs/Web/API/Element/animationcancel_event)
|
||||
|
||||
[`OnTransitionStart`](https://developer.mozilla.org/en-US/docs/Web/API/Element/transitionstart_event)
|
||||
|
||||
@@ -224,4 +224,4 @@ For detailed API documentation, inspect the following API references:
|
||||
|
||||
### Positioning
|
||||
|
||||
The select pattern integrates with [CDK Overlay](https://material.angular.io/cdk/overlay/overview) for smart positioning. Use `cdkConnectedOverlay` to handle viewport edges and scrolling automatically.
|
||||
The select pattern integrates with [CDK Overlay](https://material.angular.dev/cdk/overlay/overview) for smart positioning. Use `cdkConnectedOverlay` to handle viewport edges and scrolling automatically.
|
||||
|
||||
@@ -279,7 +279,7 @@ An asset specification object can have the following fields.
|
||||
|
||||
| Fields | Details |
|
||||
| :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `glob` | A [node-glob](https://github.com/isaacs/node-glob/blob/master/README.md) using `input` as base directory. |
|
||||
| `glob` | A [node-glob](https://github.com/isaacs/node-glob/blob/main/README.md) using `input` as base directory. |
|
||||
| `input` | A path relative to the workspace root. |
|
||||
| `output` | A path relative to `outDir`. Because of the security implications, the Angular CLI never writes files outside of the project output path. |
|
||||
| `ignore` | A list of globs to exclude. |
|
||||
|
||||
@@ -16,4 +16,4 @@ Ensure that there are no changes to the bindings in the template after change de
|
||||
|
||||
If you are binding to methods in the view, ensure that the invocation does not update any of the other bindings in the template.
|
||||
|
||||
Read more about which solution is right for you in ['Everything you need to know about the "ExpressionChangedAfterItHasBeenCheckedError" error'](https://angularindepth.com/posts/1001/everything-you-need-to-know-about-the-expressionchangedafterithasbeencheckederror-error) and why this is useful at ['Angular Debugging "Expression has changed after it was checked": Simple Explanation (and Fix)'](https://blog.angular-university.io/angular-debugging).
|
||||
Read more about which solution is right for you in ['Everything you need to know about the "ExpressionChangedAfterItHasBeenCheckedError" error'](https://medium.com/angular-in-depth/everything-you-need-to-know-about-the-expressionchangedafterithasbeencheckederror-error-e3fd9ce7dbb4) and why this is useful at ['Angular Debugging "Expression has changed after it was checked": Simple Explanation (and Fix)'](https://blog.angular-university.io/angular-debugging).
|
||||
|
||||
@@ -91,7 +91,7 @@ At the same time, the AOT **collector** analyzes the metadata recorded in the An
|
||||
|
||||
You can think of `.metadata.json` as a diagram of the overall structure of a decorator's metadata, represented as an [abstract syntax tree (AST)](https://en.wikipedia.org/wiki/Abstract_syntax_tree).
|
||||
|
||||
HELPFUL: Angular's [schema.ts](https://github.com/angular/angular/blob/main/packages/compiler-cli/src/metadata/schema.ts) describes the JSON format as a collection of TypeScript interfaces.
|
||||
HELPFUL: Angular's [schema.ts](https://github.com/angular/angular/blob/12.2.x/packages/compiler-cli/src/metadata/schema.ts) describes the JSON format as a collection of TypeScript interfaces.
|
||||
|
||||
### Expression syntax limitations
|
||||
|
||||
|
||||
@@ -30,10 +30,10 @@ You can read more by following the links associated with the package names below
|
||||
|
||||
| Deployment to | Setup Command |
|
||||
| :---------------------------------------------------------------- | :------------------------------------------------------------------------------------------ |
|
||||
| [Firebase hosting](https://firebase.google.com/docs/hosting) | [`ng add @angular/fire`](https://npmjs.org/package/@angular/fire) |
|
||||
| [Firebase hosting](https://firebase.google.com/docs/hosting) | [`ng add @angular/fire`](https://www.npmjs.com/package/@angular/fire) |
|
||||
| [Vercel](https://vercel.com/solutions/angular) | [`vercel init angular`](https://github.com/vercel/vercel/tree/main/examples/angular) |
|
||||
| [Netlify](https://www.netlify.com) | [`ng add @netlify-builder/deploy`](https://npmjs.org/package/@netlify-builder/deploy) |
|
||||
| [GitHub Pages](https://pages.github.com) | [`ng add angular-cli-ghpages`](https://npmjs.org/package/angular-cli-ghpages) |
|
||||
| [Netlify](https://www.netlify.com) | [`ng add @netlify-builder/deploy`](https://www.npmjs.com/package/@netlify-builder/deploy) |
|
||||
| [GitHub Pages](https://pages.github.com) | [`ng add angular-cli-ghpages`](https://www.npmjs.com/package/angular-cli-ghpages) |
|
||||
| [Amazon Cloud S3](https://aws.amazon.com/s3/?nc2=h_ql_prod_st_s3) | [`ng add @jefiozie/ngx-aws-deploy`](https://www.npmjs.com/package/@jefiozie/ngx-aws-deploy) |
|
||||
|
||||
If you're deploying to a self-managed server or there's no builder for your favorite cloud platform, you can either [create a builder](tools/cli/cli-builder) that allows you to use the `ng deploy` command, or read through this guide to learn how to manually deploy your application.
|
||||
|
||||
@@ -107,7 +107,7 @@ We analyzed your package.json, there are some packages to update:
|
||||
|
||||
If you pass the command a set of libraries to update, it updates those libraries, their peer dependencies, and the peer dependencies that depend on them.
|
||||
|
||||
HELPFUL: If there are inconsistencies \(for example, if peer dependencies cannot be matched by a simple [semver](https://semver.io) range\), the command generates an error and does not change anything in the workspace.
|
||||
HELPFUL: If there are inconsistencies \(for example, if peer dependencies cannot be matched by a simple [semver](https://semver.org) range\), the command generates an error and does not change anything in the workspace.
|
||||
|
||||
We recommend that you do not force an update of all dependencies by default.
|
||||
Try updating specific dependencies first.
|
||||
|
||||
@@ -243,7 +243,7 @@ The end result of these optimizations should be smaller bundle size and better c
|
||||
This optimization can break your code if it contains non-local side-effects - this is however not common in Angular applications and it's usually a sign of bad design.
|
||||
The recommendation is for all packages to claim the side-effect free status by setting the `sideEffects` property to `false`, and that developers follow the [Angular Style Guide](/style-guide) which naturally results in code without non-local side-effects.
|
||||
|
||||
More info: [webpack docs on side effects](https://github.com/webpack/webpack/tree/master/examples/side-effects)
|
||||
More info: [webpack docs on side effects](https://github.com/webpack/webpack/tree/main/examples/side-effects)
|
||||
|
||||
### ES2022 language level
|
||||
|
||||
|
||||
@@ -131,7 +131,7 @@ For more information, see [Schematics Overview](tools/cli/schematics) and [Schem
|
||||
|
||||
Use the Angular CLI and the npm package manager to build and publish your library as an npm package.
|
||||
|
||||
Angular CLI uses a tool called [ng-packagr](https://github.com/ng-packagr/ng-packagr/blob/master/README.md) to create packages from your compiled code that can be published to npm.
|
||||
Angular CLI uses a tool called [ng-packagr](https://github.com/ng-packagr/ng-packagr/blob/main/README.md) to create packages from your compiled code that can be published to npm.
|
||||
See [Building libraries with Ivy](tools/libraries/creating-libraries#publishing-libraries) for information on the distribution formats supported by `ng-packagr` and guidance on how
|
||||
to choose the right format for your library.
|
||||
|
||||
@@ -149,7 +149,7 @@ npm publish
|
||||
## Managing assets in a library
|
||||
|
||||
In your Angular library, the distributable can include additional assets like theming files, Sass mixins, or documentation \(like a changelog\).
|
||||
For more information [copy assets into your library as part of the build](https://github.com/ng-packagr/ng-packagr/blob/master/docs/copy-assets.md) and [embed assets in component styles](https://github.com/ng-packagr/ng-packagr/blob/master/docs/embed-assets-css.md).
|
||||
For more information [copy assets into your library as part of the build](https://github.com/ng-packagr/ng-packagr/blob/main/docs/copy-assets.md) and [embed assets in component styles](https://github.com/ng-packagr/ng-packagr/blob/main/docs/embed-assets-css.md).
|
||||
|
||||
IMPORTANT: When including additional assets like Sass mixins or pre-compiled CSS.
|
||||
You need to add these manually to the conditional ["exports"](tools/libraries/angular-package-format#exports) in the `package.json` of the primary entrypoint.
|
||||
|
||||
Reference in New Issue
Block a user