Skip to content

Commit 8529707

Browse files
authored
Update legacy change pages for Dart 3.11 (#7174)
Updates the old breaking change and language evolution pages, as while they are deprecated and set for removal in the future, developers might still stumble across them. So for now, let's keep them up to date. Also updates the what's new on the docs page with some minor clean up and the addition of a blog post.
1 parent c243ed1 commit 8529707

File tree

3 files changed

+68
-37
lines changed

3 files changed

+68
-37
lines changed

src/content/resources/breaking-changes.md

Lines changed: 20 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Breaking changes and deprecations
33
breadcrumb: Legacy
44
description: A list of breaking changes by release in Dart.
55
maxTocDepth: 2
6-
lastVerified: 2025-08-13
6+
lastVerified: 2026-02-16
77
---
88

99
{% assign versioned = '<span class="tag-label language-versioned-tag">Language versioned</span>' %}
@@ -87,21 +87,32 @@ don't include the section header.
8787

8888
## 3.11.0
8989

90-
:::note Tentative
91-
The following changes are expected to be included in the 3.11 stable release,
92-
but the final list might change before then.
93-
To reduce the potential impact of these changes, consider
94-
accounting for them before the 3.11 release.
95-
:::
96-
9790
### Tools
9891

92+
#### Analyzer
93+
94+
- {{deprecated}}
95+
The [`avoid_null_checks_in_equality_operators`][] lint rule
96+
is deprecated and should be removed from `analysis_options.yaml` files.
97+
98+
- {{deprecated}}
99+
The [`prefer_final_parameters`][] lint rule
100+
is deprecated and should be removed from `analysis_options.yaml` files.
101+
102+
- {{deprecated}}
103+
The [`use_if_null_to_convert_nulls_to_bools`][] lint rule
104+
is deprecated and should be removed from `analysis_options.yaml` files.
105+
106+
[`avoid_null_checks_in_equality_operators`]: /tools/linter-rules/avoid_null_checks_in_equality_operators
107+
[`prefer_final_parameters`]: /tools/linter-rules/prefer_final_parameters
108+
[`use_if_null_to_convert_nulls_to_bools`]: /tools/linter-rules/use_if_null_to_convert_nulls_to_bools
109+
99110
#### Wasm compilation (`dart compile wasm`)
100111

101112
- {{removed}}
102113
Code that imports `dart:js_util` or `package:js` now
103114
[results in a compilation error][61550] when compiling to WebAssembly.
104-
115+
105116
Invoking any API from these libraries will result in a runtime error.
106117
Usages should be migrated to `dart:js_interop` and `dart:js_interop_unsafe`.
107118

src/content/resources/language/evolution.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Dart language evolution
33
shortTitle: Language evolution
44
breadcrumb: Legacy
55
description: Notable changes and additions to the Dart programming language.
6-
lastVerified: 2024-08-04
6+
lastVerified: 2026-02-16
77
---
88

99
:::warning
@@ -50,6 +50,17 @@ on the Dart language GitHub repo.
5050
5151
## Changes in each release
5252
53+
### Dart 3.11
54+
_Released 9 February 2026_
55+
| [Dart 3.11 announcement](https://blog.dart.dev/announcing-dart-3-11-b6529be4203a)
56+
57+
While Dart 3.11 introduces no new language features,
58+
the release includes several improvements to
59+
analyzer and editor support for the
60+
[dot shorthand][] syntax introduced in Dart 3.10.
61+
62+
[dot shorthand]: /language/dot-shorthands
63+
5364
### Dart 3.10
5465
_Released 12 November 2025_
5566
| [Dart 3.10 announcement](https://blog.dart.dev/ea8b952b6088)

src/content/resources/whats-new.md

Lines changed: 36 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ This page describes what's new on the Dart website and blog.
88
To see what's new in Flutter, visit the
99
[Flutter what's new page.][flutter-whats-new]
1010

11-
For a list of Dart language changes in each Dart SDK, see the
11+
For a list of Dart language changes in each Dart SDK, see the
1212
[Dart changelog][dart-changelog].
1313
To stay on top of announcements, including breaking changes,
1414
join the [Dart announcements Google group][dart-announce]
@@ -29,31 +29,30 @@ For details about the 3.11 release of Dart,
2929
check out the [3.11 announcement][] and the
3030
[3.11 SDK changelog][3-11-changelog].
3131

32+
[3.11 announcement]: https://blog.dart.dev/announcing-dart-3-11-b6529be4203a
33+
[3-11-changelog]: https://github.com/dart-lang/sdk/blob/main/CHANGELOG.md#3110
34+
3235
### Documentation updates {:.no_toc}
3336

3437
* Launched a new [getting started experience][learn] for learning Dart.
35-
* Updated the [IntelliJ & Android Studio page][] following the transition
38+
* Updated the [IntelliJ & Android Studio page][] following the transition
3639
of the Dart plugin to the Dart team.
37-
* Added documentation about the environment variables available
40+
* Added documentation about the environment variables available
3841
to Dart's [build hooks][].
39-
* Included "Format on save" setup instructions for IDEs
42+
* Included "Format on save" setup instructions for IDEs
4043
on the [dart format][] page.
4144
(Thank you, [Anushree Bondia](https://github.com/Anushreebasics).)
4245
* Expanded the [Glossary][] with new terms including "dependency graph",
4346
"AOT", "JIT", "interop", and "scope".
44-
(Thank you, [IldySilva](https://github.com/IldySilva)
47+
(Thank you, [IldySilva](https://github.com/IldySilva)
4548
and [Anushree Bondia](https://github.com/Anushreebasics).)
4649

47-
48-
[3.11 announcement]: https://blog.dart.dev/announcing-dart-3-11-b6529be4203a
49-
[3-11-changelog]: https://github.com/dart-lang/sdk/blob/main/CHANGELOG.md#3110
5050
[learn]: /learn
5151
[Glossary]: /resources/glossary
5252
[IntelliJ & Android Studio page]: /tools/jetbrains-plugin
5353
[build hooks]: /tools/hooks
5454
[dart format]: /tools/dart-format
5555

56-
5756
## 3.10 release
5857

5958
_Released on: November 12, 2025_
@@ -64,6 +63,9 @@ For details about the 3.10 release of Dart,
6463
check out the [3.10 announcement][] and the
6564
[3.10 SDK changelog][3-10-changelog].
6665

66+
[3.10 announcement]: https://blog.dart.dev/announcing-dart-3-10-ea8b952b6088
67+
[3-10-changelog]: https://github.com/dart-lang/sdk/blob/main/CHANGELOG.md#3100
68+
6769
### Documentation updates {:.no_toc}
6870

6971
* Added a guide for the new [dot shorthands][] language feature.
@@ -75,6 +77,13 @@ check out the [3.10 announcement][] and the
7577
"closurization", "callback", "tree shaking", and "native asset".
7678
(Thank you, [IldySilva](https://github.com/IldySilva))
7779

80+
[dot shorthands]: /language/dot-shorthands
81+
[analyzer plugin]: /tools/analyzer-plugins
82+
[`dart build`]: /tools/dart-build
83+
[`dart install`]: /tools/dart-install
84+
[`@Deprecated` annotation]: /language/metadata
85+
[Glossary]: /resources/glossary
86+
7887
### Site improvements {:.no_toc}
7988

8089
* Migrated core site infrastructure to the [Jaspr framework][Jaspr migration]
@@ -85,22 +94,21 @@ check out the [3.10 announcement][] and the
8594
card-based layout.
8695
* Started compiling client-side Dart code to [Wasm][Wasm compilation].
8796

88-
[3.10 announcement]: https://blog.dart.dev/announcing-dart-3-10-ea8b952b6088
89-
[3-10-changelog]: https://github.com/dart-lang/sdk/blob/main/CHANGELOG.md
90-
[dot shorthands]: /language/dot-shorthands
91-
[analyzer plugin]: /tools/analyzer-plugins
92-
[`dart build`]: /tools/dart-build
93-
[`dart install`]: /tools/dart-install
94-
[`@Deprecated` annotation]: /language/metadata
95-
[Glossary]: /resources/glossary
96-
[IntelliJ & Android Studio page]: /tools/jetbrains-plugin
9797
[Jaspr migration]: https://jaspr.site
9898
[Table of Contents extension]: https://github.com/dart-lang/site-www/pull/6886
9999
[Glossary filtering]: https://github.com/dart-lang/site-www/pull/6945
100100
[Glossary tooltips]: https://github.com/dart-lang/site-www/pull/6969
101101
[Community page redesign]: https://github.com/dart-lang/site-www/pull/6900
102102
[Wasm compilation]: https://github.com/dart-lang/site-www/pull/6953
103103

104+
### Articles added to the Dart blog {:.no_toc}
105+
106+
We published the following articles on the Dart blog:
107+
108+
* [Google Summer of Code 2025 Results][blog-10-21-25]
109+
110+
[blog-10-21-25]: https://blog.dart.dev/google-summer-of-code-2025-results-596cf0a43422
111+
104112
## 3.9 release
105113

106114
_Released on: August 13, 2025_
@@ -266,8 +274,8 @@ check out the [3.7 announcement][] and the [SDK changelog][3-7-changelog].
266274
In addition to bug fixes and incremental improvements,
267275
we made the following changes to this site:
268276

269-
* Introduced the new type system algoritm, [inference using bounds][].
270-
* Added links to our new [Bluesky][] account.
277+
* Introduced the new type system algorithm, [inference using bounds][].
278+
* Added links to our new [Bluesky][] account.
271279
* Updated the [`dart format`][] page to reflect the new formatter style,
272280
including the new [configurable line length][] feature.
273281
* Documented the new [shared analysis options][] feature.
@@ -276,13 +284,14 @@ we made the following changes to this site:
276284
* Introduced details of [stray files][] to the Workspaces page.
277285
* Added the new language feature [wildcard variables][] to the Variables page.
278286
* Moved [covariant explanation][] to the better-suited Type system page.
279-
* Changed references to [legacy JS interop][] libraries explicitly to "deprecated".
280-
* Removed the experimental macros page, since the team [indefinitely paused][]
281-
work on the feature.
282-
* Added a [warning][map-warn] that destructuring a Map pattern by a non-existent key will
283-
throw a `StateError`.
284-
* Revamped the [linter rules][] page with new cards, search format, and color-coded
285-
icons on the individual lint pages ([for example][]).
287+
* Changed references to the [legacy JS interop][]
288+
libraries to be explicitly "deprecated".
289+
* Removed the experimental macros page, since the team
290+
[indefinitely paused][] work on the feature.
291+
* Added a [warning][map-warn] that destructuring a Map pattern by
292+
a non-existent key will throw a `StateError`.
293+
* Revamped the [linter rules][] page with new cards, search format, and
294+
color-coded icons on the individual lint pages ([for example][]).
286295
* Redesigned the layout implementation and sidenav for efficiency.
287296
* Removed the officially-deprecated `dart:html` library page.
288297

0 commit comments

Comments
 (0)