Skip to content

Commit

Permalink
docs: update releases guide for v16 (angular#50128)
Browse files Browse the repository at this point in the history 
Also clarify that the deprecations guide is for _noteworthy_ deprecations and may not be comprehensive.

PR Close angular#50128
  • Loading branch information
@jelbourn @alxhub
jelbourn authored and alxhub committed May 9, 2023
1 parent a1dc3bb commit ed7c881
Show file tree
Hide file tree
Showing 3 changed files with 58 additions and 52 deletions.
6 changes: 4 additions & 2 deletions aio/content/guide/deprecations.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,9 @@ Sometimes, APIs and features become obsolete and need to be removed or replaced
To make these transitions as easy as possible, APIs and features are deprecated for a period of time before they are removed.
This gives you time to update your applications to the latest APIs and best practices.

This guide contains a summary of all Angular APIs and features that are currently deprecated.
This guide contains a summary of noteworthy Angular APIs and features that are currently deprecated.
See the [full changelog](https://github.com/angular/angular/blob/main/CHANGELOG.md) for
comprehensive details on deprecations and breaking changes.

<div class="alert is-helpful">

Expand Down Expand Up @@ -746,4 +748,4 @@ If you rely on the behavior that the same object instance should cause change de

<!-- end links -->

@reviewed 2022-02-28
@reviewed 2023-05-03
20 changes: 10 additions & 10 deletions aio/content/guide/releases.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -104,17 +104,17 @@ This cadence of releases gives eager developers access to new features as soon a

<div class="alert is-helpful">

Dates are offered as general guidance and are subject to change.
Approximate dates are offered as general guidance and are subject to change.

</div>

### Release schedule

| Version | Date |
| :--- | :--- |
| v15.1 | Week of 2023-01-09 |
| v15.2 | Week of 2023-02-20 |
| v16.0 | Week of 2023-05-01 |
|:--------|:-------------------|
| v16.1 | Week of 2023-06-12 |
| v16.2 | Week of 2023-07-24 |
| v17.0 | Week of 2023-11-06 |

### Support window

Expand All @@ -130,12 +130,12 @@ All major releases are typically supported for 18 months.
The following table provides the status for Angular versions under support.

| Version | Status | Released | Active ends | LTS ends |
|:--- |:--- |:--- |:--- |:--- |
| ^15.0.0 | Active | 2022-11-18 | 2023-05-18 | 2024-05-18 |
|:--------|:-------|:-----------|:------------|:-----------|
| ^16.0.0 | Active | 2023-05-03 | 2023-11-03 | 2024-11-08 |
| ^15.0.0 | LTS | 2022-11-18 | 2023-05-03 | 2024-05-18 |
| ^14.0.0 | LTS | 2022-06-02 | 2022-11-18 | 2023-11-18 |
| ^13.0.0 | LTS | 2021-11-04 | 2022-06-02 | 2023-05-04 |

Angular versions v2 to v12 are no longer under support.
Angular versions v2 to v13 are no longer supported.

### LTS fixes

Expand Down Expand Up @@ -189,4 +189,4 @@ The policies and practices that are described in this document do not apply to A

<!-- end links -->

@reviewed 2022-11-21
@reviewed 2023-05-03
84 changes: 44 additions & 40 deletions aio/content/guide/versions.md
View file
Original file line number Diff line number Diff line change
@@ -1,56 +1,60 @@
# Version compatibility

The following tables describe the versions of Node.js, TypeScript, and RxJS that each version of Angular requires.
The following tables describe the versions of Node.js, TypeScript, and RxJS that each version of
Angular requires.

## Actively supported versions

This table covers [Angular versions under active support](guide/releases#actively-supported-versions).
This table
covers [Angular versions under active support](guide/releases#actively-supported-versions).

| Angular | Node.js | TypeScript | RxJS |
| ------------------ | ------------------------------------ | -------------- | ------------------ |
|--------------------|--------------------------------------|----------------|--------------------|
| 16.0.x | ^16.14.0 \|\| ^18.10.0 | >=4.9.3 <5.1.0 | ^6.5.3 \|\| ^7.4.0 |
| 15.1.x \|\| 15.2.x | ^14.20.0 \|\| ^16.13.0 \|\| ^18.10.0 | >=4.8.2 <5.0.0 | ^6.5.3 \|\| ^7.4.0 |
| 15.0.x | ^14.20.0 \|\| ^16.13.0 \|\| ^18.10.0 | ~4.8.2 | ^6.5.3 \|\| ^7.4.0 |
| 14.2.x \|\| 14.3.x | ^14.15.0 \|\| ^16.10.0 | >=4.6.2 <4.9.0 | ^6.5.3 \|\| ^7.4.0 |
| 14.0.x \|\| 14.1.x | ^14.15.0 \|\| ^16.10.0 | >=4.6.2 <4.8.0 | ^6.5.3 \|\| ^7.4.0 |
| 13.3.x | ^12.20.0 \|\| ^14.15.0 \|\| ^16.10.0 | >=4.4.3 <4.7.0 | ^6.5.3 \|\| ^7.4.0 |
| 13.1.x \|\| 13.2.x | ^12.20.0 \|\| ^14.15.0 \|\| ^16.10.0 | >=4.4.3 <4.6.0 | ^6.5.3 \|\| ^7.4.0 |
| 13.0.x | ^12.20.0 \|\| ^14.15.0 \|\| ^16.10.0 | ~4.4.3 | ^6.5.3 \|\| ^7.4.0 |

## Unsupported Angular versions

This table covers Angular versions that are no longer under long-term support (LTS). This information was correct when each version went out of LTS and is provided without any further guarantees. It is listed here for historical reference.
This table covers Angular versions that are no longer under long-term support (LTS). This
information was correct when each version went out of LTS and is provided without any further
guarantees. It is listed here for historical reference.

| Angular | Angular CLI | Node.js | TypeScript | RxJS |
| --------------------------- | ---------------- | ---------------------- | -------------- | ------------------ |
| 12.2.x | 12.2.x | ^12.14.0 \|\| ^14.15.0 | >=4.2.3 <4.4.0 | ^6.5.3 \|\| ^7.0.0 |
| 12.1.x | 12.1.x | ^12.14.0 \|\| ^14.15.0 | >=4.2.3 <4.4.0 | ^6.5.3 |
| 12.0.x | 12.0.x | ^12.14.0 \|\| ^14.15.0 | ~4.2.3 | ^6.5.3 |
| 11.2.x | 11.2.x | ^10.13.0 \|\| ^12.11.0 | >=4.0.0 <4.2.0 | ^6.5.3 |
| 11.1.x | 11.1.x | ^10.13.0 \|\| ^12.11.0 | >=4.0.0 <4.2.0 | ^6.5.3 |
| 11.0.x | 11.0.x | ^10.13.0 \|\| ^12.11.0 | ~4.0.0 | ^6.5.3 |
| 10.2.x | 10.2.x | ^10.13.0 \|\| ^12.11.0 | >=3.9.0 <4.1.0 | ^6.5.3 |
| 10.1.x | 10.1.x | ^10.13.0 \|\| ^12.11.0 | >=3.9.0 <4.1.0 | ^6.5.3 |
| 10.0.x | 10.0.x | ^10.13.0 \|\| ^12.11.0 | ~3.9.0 | ^6.5.3 |
| 9.1.x | 9.1.x | ^10.13.0 \|\| ^12.11.0 | >=3.6.0 <3.9.0 | ^6.5.3 |
| 9.0.x | 9.0.x | ^10.13.0 \|\| ^12.11.0 | >=3.6.0 <3.8.0 | ^6.5.3 |
| 8.2.x | 8.3.x | ^10.9.0 | >=3.5.3 <3.6.0 | ^6.4.0 |
| 8.2.x | 8.2.x | ^10.9.0 | >=3.4.2 | ^6.4.0 |
| 8.1.x | 8.1.x | ^10.9.0 | ~3.4.2 | ^6.4.0 |
| 8.0.x | 8.0.x | ^10.9.0 | ~3.4.2 | ^6.4.0 |
| 7.2.x | 7.3.x | ^8.9.0 \|\| ^10.9.0 | ~3.2.2 | ^6.0.0 |
| 7.2.x | 7.2.x | ^8.9.0 \|\| ^10.9.0 | ~3.2.2 | ^6.0.0 |
| 7.1.x | 7.1.x | ^8.9.0 \|\| ^10.9.0 | ~3.1.3 | ^6.0.0 |
| 7.0.x | 7.0.x | ^8.9.0 \|\| ^10.9.0 | ~3.1.3 | ^6.0.0 |
| 6.1.x | 6.2.x | ^8.9.0 | ~2.9.2 | ^6.0.0 |
| 6.1.x | 6.1.x | ^8.9.0 | ~2.7.2 | ^6.0.0 |
| 6.0.x | 6.0.x | ^8.9.0 | ~2.7.2 | ^6.0.0 |
| 5.2.x | 1.6.x \|\| 1.7.x | ^6.9.0 \|\| ^8.9.0 | ~2.5.0 | ^5.5.0 |
| 5.1.x | 1.5.x | ^6.9.0 \|\| ^8.9.0 | >=2.4.0 <2.6.0 | ^5.5.0 |
| 5.0.x | 1.5.x | ^6.9.0 \|\| ^8.9.0 | ~2.4.0 | ^5.5.0 |
| 4.2.x \|\| 4.3.x \|\| 4.4.x | 1.4.x | ^6.9.0 \|\| ^8.9.0 | ~2.4.0 | ^5.0.1 |
| 4.2.x \|\| 4.3.x \|\| 4.4.x | 1.3.x | ^6.9.0 | ~2.4.0 | ^5.0.1 |
| 4.0.x \|\| 4.1.x | 1.2.x | ^6.9.0 | ~2.3.0 | ^5.0.1 |
| >=4.0.0 <4.2.0 | 1.1.x | ^6.9.0 | ~2.3.0 | ^5.0.1 |
| >=4.0.0 <4.2.0 | 1.0.x | ^6.9.0 | ~2.2.0 | ^5.0.1 |
| 2.x | - | ^6.9.0 | ~2.0.0 | ^5.0.1 |
| Angular | Angular CLI | Node.js | TypeScript | RxJS |
|-----------------------------|------------------|------------------------|--------------------|--------------------|
| 13.2.x | 13.2.x | >=4.4.3 <4.7.0 | ^6.5.3 \|\| ^7.4.0 | ^6.5.3 \|\| ^7.0.0 |
| 13.1.x | 13.1.x | >=4.4.3 <4.6.0 | ^6.5.3 \|\| ^7.4.0 | ^6.5.3 \|\| ^7.0.0 |
| 13.0.x | 13.0.x | ~4.4.3 | ^6.5.3 \|\| ^7.4.0 | ^6.5.3 \|\| ^7.0.0 |
| 12.2.x | 12.2.x | ^12.14.0 \|\| ^14.15.0 | >=4.2.3 <4.4.0 | ^6.5.3 \|\| ^7.0.0 |
| 12.1.x | 12.1.x | ^12.14.0 \|\| ^14.15.0 | >=4.2.3 <4.4.0 | ^6.5.3 |
| 12.0.x | 12.0.x | ^12.14.0 \|\| ^14.15.0 | ~4.2.3 | ^6.5.3 |
| 11.2.x | 11.2.x | ^10.13.0 \|\| ^12.11.0 | >=4.0.0 <4.2.0 | ^6.5.3 |
| 11.1.x | 11.1.x | ^10.13.0 \|\| ^12.11.0 | >=4.0.0 <4.2.0 | ^6.5.3 |
| 11.0.x | 11.0.x | ^10.13.0 \|\| ^12.11.0 | ~4.0.0 | ^6.5.3 |
| 10.2.x | 10.2.x | ^10.13.0 \|\| ^12.11.0 | >=3.9.0 <4.1.0 | ^6.5.3 |
| 10.1.x | 10.1.x | ^10.13.0 \|\| ^12.11.0 | >=3.9.0 <4.1.0 | ^6.5.3 |
| 10.0.x | 10.0.x | ^10.13.0 \|\| ^12.11.0 | ~3.9.0 | ^6.5.3 |
| 9.1.x | 9.1.x | ^10.13.0 \|\| ^12.11.0 | >=3.6.0 <3.9.0 | ^6.5.3 |
| 9.0.x | 9.0.x | ^10.13.0 \|\| ^12.11.0 | >=3.6.0 <3.8.0 | ^6.5.3 |
| 8.2.x | 8.3.x | ^10.9.0 | >=3.5.3 <3.6.0 | ^6.4.0 |
| 8.2.x | 8.2.x | ^10.9.0 | >=3.4.2 | ^6.4.0 |
| 8.1.x | 8.1.x | ^10.9.0 | ~3.4.2 | ^6.4.0 |
| 8.0.x | 8.0.x | ^10.9.0 | ~3.4.2 | ^6.4.0 |
| 7.2.x | 7.3.x | ^8.9.0 \|\| ^10.9.0 | ~3.2.2 | ^6.0.0 |
| 7.2.x | 7.2.x | ^8.9.0 \|\| ^10.9.0 | ~3.2.2 | ^6.0.0 |
| 7.1.x | 7.1.x | ^8.9.0 \|\| ^10.9.0 | ~3.1.3 | ^6.0.0 |
| 7.0.x | 7.0.x | ^8.9.0 \|\| ^10.9.0 | ~3.1.3 | ^6.0.0 |
| 6.1.x | 6.2.x | ^8.9.0 | ~2.9.2 | ^6.0.0 |
| 6.1.x | 6.1.x | ^8.9.0 | ~2.7.2 | ^6.0.0 |
| 6.0.x | 6.0.x | ^8.9.0 | ~2.7.2 | ^6.0.0 |
| 5.2.x | 1.6.x \|\| 1.7.x | ^6.9.0 \|\| ^8.9.0 | ~2.5.0 | ^5.5.0 |
| 5.1.x | 1.5.x | ^6.9.0 \|\| ^8.9.0 | >=2.4.0 <2.6.0 | ^5.5.0 |
| 5.0.x | 1.5.x | ^6.9.0 \|\| ^8.9.0 | ~2.4.0 | ^5.5.0 |
| 4.2.x \|\| 4.3.x \|\| 4.4.x | 1.4.x | ^6.9.0 \|\| ^8.9.0 | ~2.4.0 | ^5.0.1 |
| 4.2.x \|\| 4.3.x \|\| 4.4.x | 1.3.x | ^6.9.0 | ~2.4.0 | ^5.0.1 |
| 4.0.x \|\| 4.1.x | 1.2.x | ^6.9.0 | ~2.3.0 | ^5.0.1 |
| >=4.0.0 <4.2.0 | 1.1.x | ^6.9.0 | ~2.3.0 | ^5.0.1 |
| >=4.0.0 <4.2.0 | 1.0.x | ^6.9.0 | ~2.2.0 | ^5.0.1 |
| 2.x | - | ^6.9.0 | ~2.0.0 | ^5.0.1 |

0 comments on commit ed7c881

Please sign in to comment.