[api.dart.dev] Update incorrect URLs in the Dart SDK sources

The old site supported api.dart.dev/stable/<page in the latest version>
links. These currently don't work, but the correct link omits the
`/stable/` path component.

Even if we add redirects to make the old URLs work, we still want to
update sources with the canonical URLs.

CoreLibraryReviewExempt: Documentation change only.
Fixes: #57110
Change-Id: I0b20bfa875db5ce62362a02e884d7d43b0efc73e
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/395961
Commit-Queue: Ivan Inozemtsev <[email protected]>
Reviewed-by: Ivan Inozemtsev <[email protected]>
Commit-Queue: Alexander Thomas <[email protected]>
Auto-Submit: Alexander Thomas <[email protected]>

Author: athomas

CHANGELOG.md

@@ -2465,7 +2465,7 @@ This is a patch release that:
   spawned via `Isolate.spawnUri`. See [`SendPort.send`] documentation for
   the full list of restrictions.
 
-[`SendPort.send`]: https://api.dart.dev/stable/dart-isolate/SendPort/send.html
+[`SendPort.send`]: https://api.dart.dev/dart-isolate/SendPort/send.html
 
 #### `dart:mirrors`
 
@@ -2474,8 +2474,8 @@ This is a patch release that:
   previously used internally in dart2js. Both are no longer functional.
 
 [#34233]: https://github.com/dart-lang/sdk/issues/34233
-[`MirrorsUsed`]: https://api.dart.dev/stable/dart-mirrors/MirrorsUsed-class.html
-[`Comment`]: https://api.dart.dev/stable/dart-mirrors/Comment-class.html
+[`MirrorsUsed`]: https://api.dart.dev/dart-mirrors/MirrorsUsed-class.html
+[`Comment`]: https://api.dart.dev/dart-mirrors/Comment-class.html
 
 ### Other libraries
 
@@ -5564,7 +5564,7 @@ Thanks to **Vincenzo di Cicco** for finding and reporting this issue.
 This release also improves compatibility with ARMv8 processors (issue [40001][])
 and dart:io stability (issue [40589][]).
 
-[nodevalidator]: https://api.dart.dev/stable/dart-html/NodeValidator-class.html
+[nodevalidator]: https://api.dart.dev/dart-html/NodeValidator-class.html
 [cve-2020-8923]:
   https://github.com/dart-lang/sdk/security/advisories/GHSA-hfq3-v9pv-p627
 [40001]: https://github.com/dart-lang/sdk/issues/40001

docs/gsoc/Dart-GSoC-2023-Project-Ideas.md

@@ -119,7 +119,7 @@ Successfully completely this project will likely involve:
 
   * Determining exactly what APIs should be make available in Dart.
   * Creating a JNI bindings for those APIs using [`package:jnigen`](https://pub.dev/packages/jnigen).
-  * Creating a higher-level interface over the JNI bindings e.g. so the Dart developer can work with [Dart URIs](https://api.dart.dev/stable/dart-core/Uri-class.html) rather than [java.net.URI](https://developer.android.com/reference/java/net/URI).
+  * Creating a higher-level interface over the JNI bindings e.g. so the Dart developer can work with [Dart URIs](https://api.dart.dev/dart-core/Uri-class.html) rather than [java.net.URI](https://developer.android.com/reference/java/net/URI).
   * Creating a [`package:http` `Client`](https://pub.dev/documentation/http/latest/http/Client-class.html) implementation using the interface above.
   * Verifying that the `Client` implementation passes the [conformance tests](https://github.com/dart-lang/http/tree/main/pkgs/http_client_conformance_tests).
 
@@ -135,19 +135,19 @@ A good project proposal will describe what Java APIs are necessary to implement
 
 
 
-## **Idea:** Refactor Plus packages to utilize new Dart 3 language features 
+## **Idea:** Refactor Plus packages to utilize new Dart 3 language features
 
  - **Possible Mentor(s)**: Majid Hajian <[email protected]>
  - **Difficulty**: Hard
  - **Project size**: / Medium (175 hours)
  - **Skills**: Dart
 
-**Description**: Dart 3 introduces a few new language features. There are several features such as Records, pattern matching and new direct platform library interop which potentially helps to improve code readability and better API design for packages. 
+**Description**: Dart 3 introduces a few new language features. There are several features such as Records, pattern matching and new direct platform library interop which potentially helps to improve code readability and better API design for packages.
 
 We would like to explore the possibilities of the new language features that could help to improve packages and create a new API (potentially) or refactor internal coding that make the package to take full advantage of Dart 3. We would like to also prepare a guideline after this refactoring for other maintainers to figure out what could be improved or changed.
 
 We are using [Federated plugins](https://flutter.dev/to/federated-plugins), therefore this is likely to involve:
- 
+
 * refactoring `platform_interface` class for each package,
 * refactoring app-facing and platform-specific-implementation packages,
 * potentially removing native code and replacing it with direct dart API calls,

pkg/vm_service/java/src/org/dartlang/vm/service/VmServiceBase.java

@@ -298,7 +298,7 @@ public void received(Sentinel response) {
   /**
    * Invoke a specific service protocol extension method.
    * <p>
-   * See https://api.dart.dev/stable/dart-developer/dart-developer-library.html.
+   * See https://api.dart.dev/dart-developer/dart-developer-library.html.
    */
   public void callServiceExtension(String isolateId, String method, ServiceExtensionConsumer consumer) {
     JsonObject params = new JsonObject();
@@ -309,7 +309,7 @@ public void callServiceExtension(String isolateId, String method, ServiceExtensi
   /**
    * Invoke a specific service protocol extension method.
    * <p>
-   * See https://api.dart.dev/stable/dart-developer/dart-developer-library.html.
+   * See https://api.dart.dev/dart-developer/dart-developer-library.html.
    */
   public void callServiceExtension(String isolateId, String method, JsonObject params, ServiceExtensionConsumer consumer) {
     params.addProperty("isolateId", isolateId);

pkg/vm_service/lib/src/dart_io_extensions.dart

@@ -703,7 +703,7 @@ class HttpProfileResponseData {
   /// received across the wire and whether callers will receive compressed or
   /// uncompressed bytes when they listed to this response's byte stream.
   ///
-  /// See [HttpClientResponseCompressionState](https://api.dart.dev/stable/dart-io/HttpClientResponseCompressionState-class.html) for possible values.
+  /// See [HttpClientResponseCompressionState](https://api.dart.dev/dart-io/HttpClientResponseCompressionState-class.html) for possible values.
   final String? compressionState;
 
   /// The reason phrase associated with the status code.

pkg/vm_service/lib/src/vm_service.dart

@@ -1857,7 +1857,7 @@ class VmService {
 
   /// Invoke a specific service protocol extension method.
   ///
-  /// See https://api.dart.dev/stable/dart-developer/dart-developer-library.html.
+  /// See https://api.dart.dev/dart-developer/dart-developer-library.html.
   Future<Response> callServiceExtension(String method,
       {String? isolateId, Map<String, dynamic>? args}) {
     if (args == null && isolateId == null) {

pkg/vm_service/tool/dart/generate_dart_client.dart

@@ -47,7 +47,7 @@ export 'snapshot_graph.dart' show HeapSnapshotClass,
 
   /// Invoke a specific service protocol extension method.
   ///
-  /// See https://api.dart.dev/stable/dart-developer/dart-developer-library.html.
+  /// See https://api.dart.dev/dart-developer/dart-developer-library.html.
   Future<Response> callServiceExtension(String method, {
     String? isolateId,
     Map<String, dynamic>? args

runtime/docs/README.md

@@ -68,7 +68,7 @@ However the main difference between these lies in when and how VM converts Dart
 
 Any Dart code within the VM is running within some _isolate_, which can be best described as an isolated Dart universe with its own global state and _usually_ with its own thread of control (*mutator thread*). Isolates are grouped together into _isolate groups_. Isolate within the group share the same garbage collector managed *heap*, used as a storage for objects allocated by an isolate. Heap sharing between isolates in the same group is an implementation detail which is not observable from the Dart code. Even isolates within the same group can not share any mutable state directly and can only communicate by message passing through *ports* (not to be confused with network ports!).
 
-Isolates within a group share the same Dart program. [`Isolate.spawn`](https://api.dart.dev/stable/dart-isolate/Isolate/spawn.html) spawns an isolate within the same group, while [`Isolate.spawnUri`](https://api.dart.dev/stable/dart-isolate/Isolate/spawnUri.html) starts a new group.
+Isolates within a group share the same Dart program. [`Isolate.spawn`](https://api.dart.dev/dart-isolate/Isolate/spawn.html) spawns an isolate within the same group, while [`Isolate.spawnUri`](https://api.dart.dev/dart-isolate/Isolate/spawnUri.html) starts a new group.
 
 The relationship between OS threads and isolates is a bit blurry and highly dependent on how VM is embedded into an application. Only the following is guaranteed:
 

samples/ffi/sqlite/docs/sqlite-tutorial.md

@@ -213,7 +213,7 @@ In this minitutorial we used these `dart:ffi` features:
 * Manipulating C memory through `Pointer`s with `allocate`, `free`, `load`, `store`, and `elementAt`.
 
 There are many `dart:ffi` features not covered in this tutorial.
-Please refer to the [API documentation](https://api.dart.dev/stable/dart-ffi/dart-ffi-library.html) for more info.
+Please refer to the [API documentation](https://api.dart.dev/dart-ffi/dart-ffi-library.html) for more info.
 
 Feature which `dart:ffi` does not support:
 

sdk/lib/html/dart2js/html_dart2js.dart

@@ -30133,7 +30133,7 @@ class StaticRange extends JavaScriptObject {
  *     window.localStorage['key3'] = 'val3';
  *     assert(window.localStorage['key3'] == 'val3');
  *
- * You can use [Map](https://api.dart.dev/stable/dart-core/Map-class.html) APIs
+ * You can use [Map](https://api.dart.dev/dart-core/Map-class.html) APIs
  * such as containsValue(), clear(), and length:
  *
  *     assert(window.localStorage.containsValue('does not exist') == false);

tools/dom/templates/html/impl/impl_Storage.darttemplate

@@ -16,7 +16,7 @@ part of $LIBRARYNAME;
  *     window.localStorage['key3'] = 'val3';
  *     assert(window.localStorage['key3'] == 'val3');
  *
- * You can use [Map](https://api.dart.dev/stable/dart-core/Map-class.html) APIs
+ * You can use [Map](https://api.dart.dev/dart-core/Map-class.html) APIs
  * such as containsValue(), clear(), and length:
  *
  *     assert(window.localStorage.containsValue('does not exist') == false);