Switch to more reliable flutter.dev link destinations in the tool (#150587)

Contributes to https://github.com/flutter/website/issues/10363.

packages/flutter_tools/gradle/app_plugin_loader.gradle

@@ -8,7 +8,7 @@
 logger.error("You are applying Flutter's app_plugin_loader Gradle plugin \
 imperatively using the apply script method, which is deprecated and will be \
 removed in a future release. Migrate to applying Gradle plugins with the \
-declarative plugins block: https://flutter.dev/go/flutter-gradle-plugin-apply\n\
+declarative plugins block: https://flutter.dev/to/flutter-gradle-plugin-apply\n\
 ")
 
 def pathToThisDirectory = buildscript.sourceFile.parentFile

packages/flutter_tools/gradle/flutter.gradle

@@ -8,7 +8,7 @@
 logger.error("You are applying Flutter's main Gradle plugin imperatively using \
 the apply script method, which is deprecated and will be removed in a future \
 release. Migrate to applying Gradle plugins with the declarative plugins \
-block: https://flutter.dev/go/flutter-gradle-plugin-apply\n")
+block: https://flutter.dev/to/flutter-gradle-plugin-apply\n")
 
 def pathToThisDirectory = buildscript.sourceFile.parentFile
 apply from: "$pathToThisDirectory/src/main/groovy/flutter.groovy"

packages/flutter_tools/gradle/src/main/groovy/flutter.groovy

@@ -206,7 +206,7 @@ class FlutterPlugin implements Plugin<Project> {
     /**
      * Flutter Docs Website URLs for help messages.
      */
-    private final String kWebsiteDeploymentAndroidBuildConfig = "https://docs.flutter.dev/deployment/android#reviewing-the-gradle-build-configuration"
+    private final String kWebsiteDeploymentAndroidBuildConfig = "https://flutter.dev/to/review-gradle-config"
 
     @Override
     void apply(Project project) {

packages/flutter_tools/lib/src/android/build_validation.dart

@@ -6,7 +6,7 @@ import '../base/common.dart';
 import '../build_info.dart';
 
 const String kGooglePlayVersioning = 'https://developer.android.com/studio/publish/versioning.html';
-const String kSupportedAbis = 'https://flutter.dev/docs/deployment/android#what-are-the-supported-target-architectures';
+const String kSupportedAbis = 'https://flutter.dev/to/android-supported-architectures';
 
 /// Validates that the build mode and build number are valid for a given build.
 void validateBuild(AndroidBuildInfo androidBuildInfo) {

packages/flutter_tools/lib/src/android/gradle.dart

@@ -911,7 +911,7 @@ void printHowToConsumeAar({
 ''');
   }
 
-  logger.printStatus('To learn more, visit https://flutter.dev/go/build-aar');
+  logger.printStatus('To learn more, visit https://flutter.dev/to/integrate-android-archive');
 }
 
 String _hex(List<int> bytes) {

packages/flutter_tools/lib/src/android/gradle_errors.dart

@@ -358,7 +358,7 @@ final GradleHandledError minSdkVersionHandler = GradleHandledError(
       '$textInBold\n'
       'Following this change, your app will not be available to users running Android SDKs below ${minSdkVersionMatch?.group(2)}.\n'
       'Consider searching for a version of this plugin that supports these lower versions of the Android SDK instead.\n'
-      'For more information, see: https://docs.flutter.dev/deployment/android#reviewing-the-gradle-build-configuration',
+      'For more information, see: https://flutter.dev/to/review-gradle-config',
       title: _boxTitle,
     );
     return GradleBuildStatus.exit;
@@ -592,7 +592,7 @@ final GradleHandledError incompatibleJavaAndGradleVersionsHandler = GradleHandle
       "${globals.logger.terminal.warningMark} Your project's Gradle version "
           'is incompatible with the Java version that Flutter is using for Gradle.\n\n'
           'If you recently upgraded Android Studio, consult the migration guide '
-          'at docs.flutter.dev/go/android-java-gradle-error.\n\n'
+          'at https://flutter.dev/to/to/java-gradle-incompatibility.\n\n'
           'Otherwise, to fix this issue, first, check the Java version used by Flutter by '
           'running `flutter doctor --verbose`.\n\n'
           'Then, update the Gradle version specified in ${gradlePropertiesFile.path} '

packages/flutter_tools/lib/src/base/net.dart

@@ -112,7 +112,7 @@ class Net {
         _logger.printError(error.toString());
         throwToolExit(
           'The value of $kFlutterStorageBaseUrl ($overrideUrl) could not be '
-          'parsed as a valid url. Please see https://flutter.dev/community/china '
+          'parsed as a valid url. Please see https://flutter.dev/to/use-mirror-site '
           'for an example of how to use it.\n'
           'Full URL: $url',
           exitCode: kNetworkProblemExitCode,

packages/flutter_tools/lib/src/base/user_messages.dart

@@ -22,16 +22,16 @@ class UserMessages {
       'Flutter version $version on channel $channel at $flutterRoot';
   String get flutterUnknownChannel =>
     'Currently on an unknown channel. Run `flutter channel` to switch to an official channel.\n'
-    "If that doesn't fix the issue, reinstall Flutter by following instructions at https://flutter.dev/docs/get-started/install.";
+    "If that doesn't fix the issue, reinstall Flutter by following instructions at https://flutter.dev/setup.";
   String get flutterUnknownVersion =>
     'Cannot resolve current version, possibly due to local changes.\n'
-    'Reinstall Flutter by following instructions at https://flutter.dev/docs/get-started/install.';
+    'Reinstall Flutter by following instructions at https://flutter.dev/setup.';
   String flutterRevision(String revision, String age, String date) =>
     'Framework revision $revision ($age), $date';
   String flutterUpstreamRepositoryUrl(String url) => 'Upstream repository $url';
   String get flutterUpstreamRepositoryUnknown =>
     'Unknown upstream repository.\n'
-    'Reinstall Flutter by following instructions at https://flutter.dev/docs/get-started/install.';
+    'Reinstall Flutter by following instructions at https://flutter.dev/setup.';
   String flutterUpstreamRepositoryUrlEnvMismatch(String url) => 'Upstream repository $url is not the same as FLUTTER_GIT_URL';
   String flutterUpstreamRepositoryUrlNonStandard(String url) =>
     'Upstream repository $url is not a standard remote.\n'
@@ -65,7 +65,7 @@ class UserMessages {
   String intellijStatusInfo(String version) => 'version $version';
   String get intellijPluginInfo =>
       'For information about installing plugins, see\n'
-      'https://flutter.dev/intellij-setup/#installing-the-plugins';
+      'https://flutter.dev/to/intellij-setup';
   String intellijMinimumVersion(String minVersion) =>
       'This install is older than the minimum recommended version of $minVersion.';
   String intellijLocation(String installPath) => 'IntelliJ at $installPath';
@@ -343,16 +343,15 @@ class UserMessages {
       'https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html\n';
 
   String androidSdkInstallUrl(Platform platform) {
-    const String baseUrl = 'https://flutter.dev/docs/get-started/install';
+    const String baseUrl = 'https://flutter.dev/to/';
-    const String fragment = '#android-setup';
     if (platform.isMacOS) {
-      return '$baseUrl/macos$fragment';
+      return '${baseUrl}macos-android-setup';
     } else if (platform.isLinux) {
-      return '$baseUrl/linux$fragment';
+      return '${baseUrl}linux-android-setup';
     } else if (platform.isWindows) {
-      return '$baseUrl/windows$fragment';
+      return '${baseUrl}windows-android-setup';
     } else {
-      return baseUrl;
+      return '${baseUrl}android-setup';
     }
   }
 }

packages/flutter_tools/lib/src/cache.dart

@@ -716,7 +716,7 @@ class Cache {
           _logger.printError(
             'Failed to retrieve Flutter tool dependencies: ${e.message}.\n'
             "If you're in China, please see this page: "
-            'https://flutter.dev/community/china',
+            'https://flutter.dev/to/china-setup',
             emphasis: true,
           );
         }
@@ -1111,7 +1111,7 @@ class ArtifactUpdater {
           _logger.printError(error.toString());
           throwToolExit(
             'The value of $kFlutterStorageBaseUrl ($overrideUrl) could not be '
-            'parsed as a valid url. Please see https://flutter.dev/community/china '
+            'parsed as a valid url. Please see https://flutter.dev/to/use-mirror-site '
             'for an example of how to use it.\n'
             'Full URL: $url',
             exitCode: kNetworkProblemExitCode,
@@ -1156,7 +1156,7 @@ class ArtifactUpdater {
           throwToolExit(
             'Flutter could not download and/or extract $url. Ensure you have '
             'network connectivity and all of the required dependencies listed at '
-            'flutter.dev/setup.\nThe original exception was: $err.'
+            'https://flutter.dev/setup.\nThe original exception was: $err.'
           );
         }
         _deleteIgnoringErrors(tempFile);

packages/flutter_tools/lib/src/commands/build_aar.dart

@@ -119,7 +119,7 @@ class BuildAarCommand extends BuildSubCommand {
   final String description = 'Build a repository containing an AAR and a POM file.\n\n'
       'By default, AARs are built for `release`, `debug` and `profile`.\n'
       'The POM file is used to include the dependencies that the AAR was compiled against.\n'
-      'To learn more about how to use these artifacts, see: https://flutter.dev/go/build-aar\n'
+      'To learn more about how to use these artifacts, see: https://flutter.dev/to/integrate-android-archive\n'
       'This command assumes that the entrypoint is "lib/main.dart". '
       'This cannot currently be configured.';
 

packages/flutter_tools/lib/src/commands/build_ios.dart

@@ -444,7 +444,7 @@ class BuildIOSArchiveCommand extends _BuildIOSSubCommand {
         );
       }
     }
-    globals.printStatus('\nTo update the settings, please refer to https://docs.flutter.dev/deployment/ios\n');
+    globals.printStatus('\nTo update the settings, please refer to https://flutter.dev/to/ios-deploy\n');
 
     // xcarchive failed or not at expected location.
     if (xcarchiveResult.exitStatus != ExitStatus.success) {

packages/flutter_tools/lib/src/commands/build_ios_framework.dart

@@ -327,7 +327,7 @@ class BuildIOSFrameworkCommand extends BuildFrameworkCommand {
           .path);
       globals.printStatus(
           '\nCopy the ${globals.fs.path.basenameWithoutExtension(pluginRegistrantHeader.path)} class into your project.\n'
-          'See https://flutter.dev/docs/development/add-to-app/ios/add-flutter-screen#create-a-flutterengine for more information.');
+          'See https://flutter.dev/to/ios-create-flutter-engine for more information.');
     }
 
     return FlutterCommandResult.success();
@@ -375,7 +375,7 @@ LICENSE
   }
   s.author                = { 'Flutter Dev Team' => 'flutter-dev@googlegroups.com' }
   s.source                = { :http => '${cache.storageBaseUrl}/flutter_infra_release/flutter/${cache.engineRevision}/$artifactsMode/artifacts.zip' }
-  s.documentation_url     = 'https://flutter.dev/docs'
+  s.documentation_url     = 'https://docs.flutter.dev'
   s.platform              = :ios, '12.0'
   s.vendored_frameworks   = 'Flutter.xcframework'
 end

packages/flutter_tools/lib/src/commands/build_macos_framework.dart

@@ -192,7 +192,7 @@ LICENSE
   }
   s.author                = { 'Flutter Dev Team' => 'flutter-dev@googlegroups.com' }
   s.source                = { :http => '${cache.storageBaseUrl}/flutter_infra_release/flutter/${cache.engineRevision}/$artifactsMode/FlutterMacOS.framework.zip' }
-  s.documentation_url     = 'https://flutter.dev/docs'
+  s.documentation_url     = 'https://docs.flutter.dev'
   s.osx.deployment_target = '10.14'
   s.vendored_frameworks   = 'FlutterMacOS.framework'
   s.prepare_command       = 'unzip FlutterMacOS.framework -d FlutterMacOS.framework'

packages/flutter_tools/lib/src/commands/create.dart

@@ -820,7 +820,7 @@ Your example app code is in $relativeExampleMain.
   if (platformsString.isNotEmpty) {
     globals.printStatus('''
 Host platform code is in the $platformsString directories under $pluginPath.
-To edit platform code in an IDE see https://flutter.dev/developing-packages/#edit-plugin-package.
+To edit platform code in an IDE see https://flutter.dev/to/edit-plugins.
 
     ''');
   }
@@ -841,7 +841,7 @@ You've created a plugin project that doesn't yet support any platforms.
 void _printPluginAddPlatformMessage(String pluginPath, String template) {
   globals.printStatus('''
 To add platforms, run `flutter create -t $template --platforms <platforms> .` under $pluginPath.
-For more information, see https://flutter.dev/go/plugin-platforms.
+For more information, see https://flutter.dev/to/pubspec-plugin-platforms.
 
 ''');
 }
@@ -881,13 +881,13 @@ void _printWarningDisabledPlatform(List<String> platforms) {
 
     globals.printStatus('''
 The desktop $platforms: ${desktop.join(', ')} $verb currently not supported on your local environment.
-For more details, see: https://flutter.dev/desktop
+For more details, see: https://flutter.dev/to/add-desktop-support
 ''');
   }
   if (web.isNotEmpty) {
     globals.printStatus('''
 The web is currently not supported on your local environment.
-For more details, see: https://flutter.dev/docs/get-started/web
+For more details, see: https://flutter.dev/to/add-web-support
 ''');
   }
 }

packages/flutter_tools/lib/src/commands/create_base.dart

@@ -708,11 +708,11 @@ abstract class CreateBase extends FlutterCommand {
 
 // A valid Dart identifier that can be used for a package, i.e. no
 // capital letters.
-// https://dart.dev/guides/language/language-tour#important-concepts
+// https://dart.dev/language#important-concepts
 final RegExp _identifierRegExp = RegExp('[a-z_][a-z0-9_]*');
 
 // non-contextual dart keywords.
-//' https://dart.dev/guides/language/language-tour#keywords
+// https://dart.dev/language/keywords
 const Set<String> _keywords = <String>{
   'abstract',
   'as',

packages/flutter_tools/lib/src/commands/generate_localizations.dart

@@ -17,7 +17,7 @@ import '../runner/flutter_command.dart';
 /// It generates Dart localization source files from arb files.
 ///
 /// For a more comprehensive tutorial on the tool, please see the
-/// [internationalization user guide](flutter.dev/go/i18n-user-guide).
+/// [internationalization guide](https://flutter.dev/to/internationalization).
 class GenerateLocalizationsCommand extends FlutterCommand {
   GenerateLocalizationsCommand({
     required FileSystem fileSystem,

packages/flutter_tools/lib/src/commands/test.dart

@@ -46,8 +46,8 @@ const String _kIntegrationTestDirectory = 'integration_test';
 /// the `*_test.dart` suffix, and run them in a single invocation.
 ///
 /// See:
-/// - https://flutter.dev/docs/cookbook/testing/unit/introduction
+/// - https://flutter.dev/to/unit-testing
-/// - https://flutter.dev/docs/cookbook/testing/widget/introduction
+/// - https://flutter.dev/to/widget-testing
 ///
 /// ## Integration Tests
 ///
@@ -59,7 +59,7 @@ const String _kIntegrationTestDirectory = 'integration_test';
 /// your package. To run these tests, use `flutter test integration_test`.
 ///
 /// See:
-/// - https://flutter.dev/docs/testing/integration-tests
+/// - https://flutter.dev/to/integration-testing
 class TestCommand extends FlutterCommand with DeviceBasedDevelopmentArtifacts {
   TestCommand({
     bool verboseHelp = false,

packages/flutter_tools/lib/src/commands/upgrade.dart

@@ -18,7 +18,7 @@ import '../version.dart';
 import 'channel.dart';
 
 // The official docs to install Flutter.
-const String _flutterInstallDocs = 'https://flutter.dev/docs/get-started/install';
+const String _flutterInstallDocs = 'https://flutter.dev/setup';
 
 class UpgradeCommand extends FlutterCommand {
   UpgradeCommand({
@@ -135,7 +135,7 @@ class UpgradeCommandRunner {
       globals.printStatus('To upgrade now, run "flutter upgrade".');
       if (flutterVersion.channel == 'stable') {
         globals.printStatus('\nSee the announcement and release notes:');
-        globals.printStatus('https://flutter.dev/docs/development/tools/sdk/release-notes');
+        globals.printStatus('https://docs.flutter.dev/release/release-notes');
       }
       return;
     }

packages/flutter_tools/lib/src/drive/web_driver_service.dart

@@ -171,7 +171,7 @@ class WebDriverService extends DriverService {
         'Unable to start a WebDriver session for web testing.\n'
         'Make sure you have the correct WebDriver server (e.g. chromedriver) running at $driverPort.\n'
         'For instructions on how to obtain and run a WebDriver server, see:\n'
-        'https://flutter.dev/docs/testing/integration-tests#running-in-a-browser\n'
+        'https://flutter.dev/to/integration-test-on-web\n'
       );
     }
 

packages/flutter_tools/lib/src/http_host_validator.dart

@@ -87,7 +87,7 @@ class HttpHostValidator extends DoctorValidator {
       if (url == null) {
         availabilityResults.add(
           'Environment variable $kPubDevOverride does not specify a valid URL: "${_platform.environment[kPubDevOverride]}"\n'
-          'Please see https://flutter.dev/community/china for an example of how to use it.'
+          'Please see https://flutter.dev/to/use-mirror-site for an example of how to use it.'
         );
       } else {
         requiredHosts.add(url);
@@ -100,7 +100,7 @@ class HttpHostValidator extends DoctorValidator {
       if (url == null) {
         availabilityResults.add(
           'Environment variable $kFlutterStorageBaseUrl does not specify a valid URL: "${_platform.environment[kFlutterStorageBaseUrl]}"\n'
-          'Please see https://flutter.dev/community/china for an example of how to use it.'
+          'Please see https://flutter.dev/to/use-mirror-site for an example of how to use it.'
         );
       } else {
         requiredHosts.add(url);

packages/flutter_tools/lib/src/ios/code_signing.dart

@@ -50,7 +50,7 @@ It's also possible that a previously installed app with the same Bundle\u0020
 Identifier was signed with a different certificate.
 
 For more information, please visit:
-  https://flutter.dev/docs/get-started/install/macos#deploy-to-ios-devices
+  https://flutter.dev/to/ios-app-signing
 
 Or run on an iOS simulator without code signing
 ════════════════════════════════════════════════════════════════════════════════''';
@@ -64,7 +64,7 @@ Provisioning Profile. Please ensure that a Development Team is selected by:
 $fixWithDevelopmentTeamInstruction
 
 For more information, please visit:
-  https://flutter.dev/docs/get-started/install/macos#deploy-to-ios-devices
+  https://flutter.dev/to/ios-development-team
 
 Or run on an iOS simulator without code signing
 ════════════════════════════════════════════════════════════════════════════════''';

packages/flutter_tools/lib/src/ios/migrations/remove_framework_link_and_embedding_migration.dart

@@ -101,7 +101,7 @@ class RemoveFrameworkLinkAndEmbeddingMigration extends ProjectMigrator {
         parameter: 'remove-frameworks',
         result: 'failure',
       ));
-      throwToolExit('Your Xcode project requires migration. See https://flutter.dev/docs/development/ios-project-migration for details.');
+      throwToolExit('Your Xcode project requires migration. See https://docs.flutter.dev/ios-project-migration for details.');
     }
 
     return line;

packages/flutter_tools/lib/src/linux/build_linux.dart

@@ -43,7 +43,7 @@ Future<void> buildLinux(
   target ??= 'lib/main.dart';
   if (!linuxProject.cmakeFile.existsSync()) {
     throwToolExit('No Linux desktop project configured. See '
-      'https://docs.flutter.dev/desktop#add-desktop-support-to-an-existing-flutter-app '
+      'https://flutter.dev/to/add-desktop-support '
       'to learn about adding Linux support to a project.');
   }
 

packages/flutter_tools/lib/src/macos/build_macos.dart

@@ -70,7 +70,7 @@ Future<void> buildMacOS({
   final Directory? xcodeWorkspace = flutterProject.macos.xcodeWorkspace;
   if (xcodeWorkspace == null) {
     throwToolExit('No macOS desktop project configured. '
-      'See https://docs.flutter.dev/desktop#add-desktop-support-to-an-existing-flutter-app '
+      'See https://flutter.dev/to/add-desktop-support '
       'to learn about adding macOS support to a project.');
   }
 

packages/flutter_tools/lib/src/macos/cocoapods.dart

@@ -27,7 +27,7 @@ import '../reporting/reporting.dart';
 const String noCocoaPodsConsequence = '''
   CocoaPods is a package manager for iOS or macOS platform code.
   Without CocoaPods, plugins will not work on iOS or macOS.
-  For more info, see https://flutter.dev/platform-plugins''';
+  For more info, see https://flutter.dev/to/platform-plugins''';
 
 const String unknownCocoaPodsConsequence = '''
   Flutter is unable to determine the installed CocoaPods's version.
@@ -44,7 +44,7 @@ const String outOfDateFrameworksPodfileConsequence = '''
 
 const String outOfDatePluginsPodfileConsequence = '''
   This can cause issues if your application depends on plugins that do not support iOS or macOS.
-  See https://flutter.dev/docs/development/packages-and-plugins/developing-packages#plugin-platforms for details.
+  See https://flutter.dev/to/pubspec-plugin-platforms for details.
   If you have local Podfile edits you would like to keep, see https://github.com/flutter/flutter/issues/45197 for instructions.''';
 
 const String cocoaPodsInstallInstructions = 'see https://guides.cocoapods.org/using/getting-started.html#installation';
@@ -84,7 +84,7 @@ const Version cocoaPodsRecommendedVersion = Version.withText(1, 13, 0, '1.13.0')
 ///
 /// See also:
 ///   * https://cocoapods.org/ - the cocoapods website.
-///   * https://flutter.dev/docs/get-started/install/macos#deploy-to-ios-devices - instructions for
+///   * https://flutter.dev/to/macos-ios-setup - instructions for
 ///     installing iOS/macOS dependencies.
 class CocoaPods {
   CocoaPods({
@@ -435,12 +435,12 @@ class CocoaPods {
           symlinksDir = xcodeProject.symlinks;
           podPlatformString = 'ios';
           platformName = 'iOS';
-          docsLink = 'https://docs.flutter.dev/deployment/ios';
+          docsLink = 'https://flutter.dev/to/ios-deploy';
         } else if (xcodeProject is MacOSProject) {
           symlinksDir = xcodeProject.ephemeralDirectory.childDirectory('.symlinks');
           podPlatformString = 'osx';
           platformName = 'macOS';
-          docsLink = 'https://docs.flutter.dev/deployment/macos';
+          docsLink = 'https://flutter.dev/to/macos-deploy';
         } else {
           return;
         }

packages/flutter_tools/lib/src/plugins.dart

@@ -257,7 +257,7 @@ class Plugin {
       const String errorMessage =
           'The flutter.plugin.platforms key cannot be used in combination with the old '
           'flutter.plugin.{androidPackage,iosPrefix,pluginClass} keys. '
-          'See: https://flutter.dev/docs/development/packages-and-plugins/developing-packages#plugin';
+          'See: https://flutter.dev/to/pubspec-plugin-platforms';
       return <String>[errorMessage];
     }
 
@@ -265,7 +265,7 @@ class Plugin {
       const String errorMessage =
           'Cannot find the `flutter.plugin.platforms` key in the `pubspec.yaml` file. '
           'An instruction to format the `pubspec.yaml` can be found here: '
-          'https://flutter.dev/docs/development/packages-and-plugins/developing-packages#plugin-platforms';
+          'https://flutter.dev/to/pubspec-plugin-platforms';
       return <String>[errorMessage];
     }
 

packages/flutter_tools/lib/src/reporting/crash_reporting.dart

@@ -75,7 +75,7 @@ class CrashReporter {
     final String similarIssuesURL = GitHubTemplateCreator.toolCrashSimilarIssuesURL(details.error.toString());
     _logger.printStatus('$similarIssuesURL\n', wrap: false);
     _logger.printStatus('To report your crash to the Flutter team, first read the guide to filing a bug.', emphasis: true);
-    _logger.printStatus('https://flutter.dev/docs/resources/bug-reports\n', wrap: false);
+    _logger.printStatus('https://flutter.dev/to/report-bugs\n', wrap: false);
 
     _logger.printStatus('Create a new GitHub issue by pasting this link into your browser and completing the issue template. Thank you!', emphasis: true);
 

packages/flutter_tools/lib/src/reporting/first_run.dart

@@ -31,7 +31,7 @@ const String _kFlutterFirstRunMessage = '''
   ║ crash reports to Google.                                                   ║
   ║                                                                            ║
   ║ Read about data we send with crash reports:                                ║
-  ║ https://flutter.dev/docs/reference/crash-reporting                         ║
+  ║ https://flutter.dev/to/crash-reporting                                     ║
   ║                                                                            ║
   ║ See Google's privacy policy:                                               ║
   ║ https://policies.google.com/privacy                                        ║

packages/flutter_tools/lib/src/runner/flutter_command.dart

@@ -1424,7 +1424,7 @@ abstract class FlutterCommand extends Command<void> {
   String get deprecationWarning {
     return '${globals.logger.terminal.warningMark} The "$name" command is '
            'deprecated and will be removed in a future version of Flutter. '
-           'See https://flutter.dev/docs/development/tools/sdk/releases '
+           'See https://flutter.dev/to/previous-releases '
            'for previous releases of Flutter.\n';
   }
 

packages/flutter_tools/lib/src/web/web_constants.dart

@@ -2,4 +2,4 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-const String kWasmMoreInfo = 'See https://flutter.dev/wasm for more information.';
+const String kWasmMoreInfo = 'See https://flutter.dev/to/wasm for more information.';

packages/flutter_tools/lib/src/windows/build_windows.dart

@@ -55,7 +55,7 @@ Future<void> buildWindows(
   if (!windowsProject.cmakeFile.existsSync()) {
     throwToolExit(
       'No Windows desktop project configured. See '
-      'https://docs.flutter.dev/desktop#add-desktop-support-to-an-existing-flutter-app '
+      'https://flutter.dev/to/add-desktop-support '
       'to learn about adding Windows support to a project.');
   }
 

packages/flutter_tools/lib/src/xcode_project.dart

@@ -409,7 +409,7 @@ class IosProject extends XcodeBasedProject {
   Future<String> _parseHostAppBundleName(BuildInfo? buildInfo) async {
     // The product name and bundle name are derived from the display name, which the user
     // is instructed to change in Xcode as part of deploying to the App Store.
-    // https://flutter.dev/docs/deployment/ios#review-xcode-project-settings
+    // https://flutter.dev/to/xcode-name-config
     // The only source of truth for the name is Xcode's interpretation of the build settings.
     String? productName;
     if (globals.xcodeProjectInterpreter?.isInstalled ?? false) {

packages/flutter_tools/templates/app/pubspec.yaml.tmpl

@@ -99,10 +99,10 @@ flutter:
   #   - images/a_dot_ham.jpeg
 
   # An image asset can refer to one or more resolution-specific "variants", see
-  # https://flutter.dev/assets-and-images/#resolution-aware
+  # https://flutter.dev/to/resolution-aware-images
 
   # For details regarding adding assets from package dependencies, see
-  # https://flutter.dev/assets-and-images/#from-packages
+  # https://flutter.dev/to/asset-from-package
 
   # To add custom fonts to your application, add a fonts section here,
   # in this "flutter" section. Each entry in this list should have a
@@ -122,5 +122,5 @@ flutter:
   #         weight: 700
   #
   # For details regarding fonts from package dependencies,
-  # see https://flutter.dev/custom-fonts/#from-packages
+  # see https://flutter.dev/to/font-from-package
 {{/withEmptyMain}}

packages/flutter_tools/templates/app_integration_test/integration_test/plugin_integration_test.dart.tmpl

@@ -6,7 +6,7 @@
 {{/withPlatformChannelPluginHook}}
 //
 // For more information about Flutter integration tests, please see
-// https://docs.flutter.dev/cookbook/testing/integration/introduction
+// https://flutter.dev/to/integration-testing
 
 
 import 'package:flutter_test/flutter_test.dart';

packages/flutter_tools/templates/app_shared/android-java.tmpl/app/build.gradle.tmpl

@@ -23,7 +23,7 @@ android {
         // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
         applicationId = "{{androidIdentifier}}"
         // You can update the following values to match your application needs.
-        // For more information, see: https://docs.flutter.dev/deployment/android#reviewing-the-gradle-build-configuration.
+        // For more information, see: https://flutter.dev/to/review-gradle-config.
         minSdk = flutter.minSdkVersion
         targetSdk = flutter.targetSdkVersion
         versionCode = flutter.versionCode

packages/flutter_tools/templates/app_shared/android-kotlin.tmpl/app/build.gradle.tmpl

@@ -23,7 +23,7 @@ android {
         // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
         applicationId = "{{androidIdentifier}}"
         // You can update the following values to match your application needs.
-        // For more information, see: https://docs.flutter.dev/deployment/android#reviewing-the-gradle-build-configuration.
+        // For more information, see: https://flutter.dev/to/review-gradle-config.
         minSdk = flutter.minSdkVersion
         targetSdk = flutter.targetSdkVersion
         versionCode = flutter.versionCode

packages/flutter_tools/templates/app_shared/android.tmpl/.gitignore

@@ -7,7 +7,7 @@ gradle-wrapper.jar
 GeneratedPluginRegistrant.java
 
 # Remember to never publicly share your keystore.
-# See https://flutter.dev/docs/deployment/android#reference-the-keystore-from-the-app
+# See https://flutter.dev/to/reference-keystore
 key.properties
 **/*.keystore
 **/*.jks

packages/flutter_tools/templates/module/common/README.md.tmpl

@@ -8,4 +8,4 @@ For help getting started with Flutter development, view the online
 [documentation](https://flutter.dev/).
 
 For instructions integrating Flutter modules to your existing applications,
-see the [add-to-app documentation](https://flutter.dev/docs/development/add-to-app).
+see the [add-to-app documentation](https://flutter.dev/to/add-to-app).

packages/flutter_tools/templates/module/common/pubspec.yaml.tmpl

@@ -49,10 +49,10 @@ flutter:
   #   - images/a_dot_ham.jpeg
 
   # An image asset can refer to one or more resolution-specific "variants", see
-  # https://flutter.dev/assets-and-images/#resolution-aware
+  # https://flutter.dev/to/resolution-aware-images
 
   # For details regarding adding assets from package dependencies, see
-  # https://flutter.dev/assets-and-images/#from-packages
+  # https://flutter.dev/to/asset-from-package
 
   # To add Flutter specific custom fonts to your application, add a fonts
   # section here, in this "flutter" section. Each entry in this list should
@@ -72,7 +72,7 @@ flutter:
   #         weight: 700
   #
   # For details regarding fonts from package dependencies,
-  # see https://flutter.dev/custom-fonts/#from-packages
+  # see https://flutter.dev/to/font-from-package
 
 
   # This section identifies your Flutter project as a module meant for

packages/flutter_tools/templates/package/README.md.tmpl

@@ -3,12 +3,12 @@ This README describes the package. If you publish this package to pub.dev,
 this README's contents appear on the landing page for your package.
 
 For information about how to write a good package README, see the guide for
-[writing package pages](https://dart.dev/guides/libraries/writing-package-pages).
+[writing package pages](https://dart.dev/tools/pub/writing-package-pages).
 
 For general information about developing packages, see the Dart guide for
-[creating packages](https://dart.dev/guides/libraries/create-library-packages)
+[creating packages](https://dart.dev/guides/libraries/create-packages)
 and the Flutter guide for
-[developing packages and plugins](https://flutter.dev/developing-packages).
+[developing packages and plugins](https://flutter.dev/to/develop-packages).
 -->
 
 TODO: Put a short description of the package here that helps potential users

packages/flutter_tools/templates/package/pubspec.yaml.tmpl

@@ -28,10 +28,10 @@ flutter:
   #   - images/a_dot_ham.jpeg
   #
   # For details regarding assets in packages, see
-  # https://flutter.dev/assets-and-images/#from-packages
+  # https://flutter.dev/to/asset-from-package
   #
   # An image asset can refer to one or more resolution-specific "variants", see
-  # https://flutter.dev/assets-and-images/#resolution-aware
+  # https://flutter.dev/to/resolution-aware-images
 
   # To add custom fonts to your package, add a fonts section here,
   # in this "flutter" section. Each entry in this list should have a
@@ -51,4 +51,4 @@ flutter:
   #         weight: 700
   #
   # For details regarding fonts in packages, see
-  # https://flutter.dev/custom-fonts/#from-packages
+  # https://flutter.dev/to/font-from-package

packages/flutter_tools/templates/package_ffi/README.md.tmpl

@@ -5,7 +5,7 @@
 ## Getting Started
 
 This project is a starting point for a Flutter
-[FFI package](https://docs.flutter.dev/development/platform-integration/c-interop),
+[FFI package](https://flutter.dev/to/ffi-package),
 a specialized package that includes native code directly invoked with Dart FFI.
 
 ## Project structure
@@ -45,5 +45,5 @@ For example, see `sumAsync` in `lib/{{projectName}}.dart`.
 ## Flutter help
 
 For help getting started with Flutter, view our
-[online documentation](https://flutter.dev/docs), which offers tutorials,
+[online documentation](https://docs.flutter.dev), which offers tutorials,
 samples, guidance on mobile development, and a full API reference.

packages/flutter_tools/templates/plugin/README.md.tmpl

@@ -5,16 +5,16 @@
 ## Getting Started
 
 This project is a starting point for a Flutter
-[plug-in package](https://flutter.dev/developing-packages/),
+[plug-in package](https://flutter.dev/to/develop-plugins),
 a specialized package that includes platform-specific implementation code for
 Android and/or iOS.
 
 For help getting started with Flutter development, view the
-[online documentation](https://flutter.dev/docs), which offers tutorials,
+[online documentation](https://docs.flutter.dev), which offers tutorials,
 samples, guidance on mobile development, and a full API reference.
 
 {{#no_platforms}}
 The plugin project was generated without specifying the `--platforms` flag, no platforms are currently supported.
 To add platforms, run `flutter create -t plugin --platforms <platforms> .` in this directory.
-You can also find a detailed instruction on how to add platforms in the `pubspec.yaml` at https://flutter.dev/docs/development/packages-and-plugins/developing-packages#plugin-platforms.
+You can also find a detailed instruction on how to add platforms in the `pubspec.yaml` at https://flutter.dev/to/pubspec-plugin-platforms.
 {{/no_platforms}}

packages/flutter_tools/templates/plugin/lib/projectName.dart.tmpl

@@ -4,7 +4,7 @@
 // platform, run `flutter create -t plugin --platforms <platforms> .` under the
 // same directory. You can also find a detailed instruction on how to add
 // platforms in the `pubspec.yaml` at
-// https://flutter.dev/docs/development/packages-and-plugins/developing-packages#plugin-platforms.
+// https://flutter.dev/to/pubspec-plugin-platforms.
 {{/no_platforms}}
 
 import '{{projectName}}_platform_interface.dart';

packages/flutter_tools/templates/plugin_ffi/README.md.tmpl

@@ -5,7 +5,7 @@
 ## Getting Started
 
 This project is a starting point for a Flutter
-[FFI plugin](https://docs.flutter.dev/development/platform-integration/c-interop),
+[FFI plugin](https://flutter.dev/to/ffi-package),
 a specialized package that includes native code directly invoked with Dart FFI.
 
 ## Project structure
@@ -87,11 +87,11 @@ For example, see `sumAsync` in `lib/{{projectName}}.dart`.
 ## Flutter help
 
 For help getting started with Flutter, view our
-[online documentation](https://flutter.dev/docs), which offers tutorials,
+[online documentation](https://docs.flutter.dev), which offers tutorials,
 samples, guidance on mobile development, and a full API reference.
 
 {{#no_platforms}}
 The plugin project was generated without specifying the `--platforms` flag, so no platforms are currently supported.
 To add platforms, run `flutter create -t plugin_ffi --platforms <platforms> .` in this directory.
-You can also find a detailed instruction on how to add platforms in the `pubspec.yaml` at https://flutter.dev/docs/development/packages-and-plugins/developing-packages#plugin-platforms.
+You can also find a detailed instruction on how to add platforms in the `pubspec.yaml` at https://flutter.dev/to/pubspec-plugin-platforms.
 {{/no_platforms}}

packages/flutter_tools/templates/plugin_ffi/lib/projectName.dart.tmpl

@@ -4,7 +4,7 @@
 // To add platforms, run `flutter create -t plugin_ffi --platforms <platforms> .`
 // in this directory. You can also find a detailed instruction on how to
 // add platforms in the `pubspec.yaml` at
-// https://flutter.dev/docs/development/packages-and-plugins/developing-packages#plugin-platforms.
+// https://flutter.dev/to/pubspec-plugin-platforms.
 {{/no_platforms}}
 
 import 'dart:async';

packages/flutter_tools/templates/plugin_shared/pubspec.yaml.tmpl

@@ -50,7 +50,7 @@ flutter:
     # This FFI plugin project was generated without specifying any
     # platforms with the `--platform` argument. If you see the `some_platform` map below, remove it and
     # then add platforms following the instruction here:
-    # https://flutter.dev/docs/development/packages-and-plugins/developing-packages#plugin-platforms
+    # https://flutter.dev/to/pubspec-plugin-platforms
     # -------------------
       some_platform:
         ffiPlugin: true
@@ -84,7 +84,7 @@ flutter:
     # This plugin project was generated without specifying any
     # platforms with the `--platform` argument. If you see the `some_platform` map below, remove it and
     # then add platforms following the instruction here:
-    # https://flutter.dev/docs/development/packages-and-plugins/developing-packages#plugin-platforms
+    # https://flutter.dev/to/pubspec-plugin-platforms
     # -------------------
       some_platform:
         pluginClass: somePluginClass
@@ -124,10 +124,10 @@ flutter:
   #   - images/a_dot_ham.jpeg
   #
   # For details regarding assets in packages, see
-  # https://flutter.dev/assets-and-images/#from-packages
+  # https://flutter.dev/to/asset-from-package
   #
   # An image asset can refer to one or more resolution-specific "variants", see
-  # https://flutter.dev/assets-and-images/#resolution-aware
+  # https://flutter.dev/to/resolution-aware-images
 
   # To add custom fonts to your plugin package, add a fonts section here,
   # in this "flutter" section. Each entry in this list should have a
@@ -147,4 +147,4 @@ flutter:
   #         weight: 700
   #
   # For details regarding fonts in packages, see
-  # https://flutter.dev/custom-fonts/#from-packages
+  # https://flutter.dev/to/font-from-package

packages/flutter_tools/templates/skeleton/README.md.tmpl

@@ -6,10 +6,10 @@
 
 This project is a starting point for a Flutter application that follows the
 [simple app state management
-tutorial](https://flutter.dev/docs/development/data-and-backend/state-mgmt/simple).
+tutorial](https://flutter.dev/to/state-management-sample).
 
 For help getting started with Flutter development, view the
-[online documentation](https://flutter.dev/docs), which offers tutorials,
+[online documentation](https://docs.flutter.dev), which offers tutorials,
 samples, guidance on mobile development, and a full API reference.
 
 ## Assets
@@ -18,7 +18,7 @@ The `assets` directory houses images, fonts, and any other files you want to
 include with your application.
 
 The `assets/images` directory contains [resolution-aware
-images](https://flutter.dev/docs/development/ui/assets-and-images#resolution-aware).
+images](https://flutter.dev/to/resolution-aware-images).
 
 ## Localization
 
@@ -26,5 +26,4 @@ This project generates localized messages based on arb files found in
 the `lib/src/localization` directory.
 
 To support additional languages, please visit the tutorial on
-[Internationalizing Flutter
+[Internationalizing Flutter apps](https://flutter.dev/to/internationalization).
-apps](https://flutter.dev/docs/development/accessibility-and-localization/internationalization)

packages/flutter_tools/templates/skeleton/test/unit_test.dart.tmpl

@@ -2,7 +2,7 @@
 //
 // A unit test tests a single function, method, or class. To learn more about
 // writing unit tests, visit
-// https://flutter.dev/docs/cookbook/testing/unit/introduction
+// https://flutter.dev/to/unit-testing
 
 import 'package:flutter_test/flutter_test.dart';
 

packages/flutter_tools/templates/skeleton/test/widget_test.dart.tmpl

@@ -5,7 +5,7 @@
 // gestures. You can also use WidgetTester to find child widgets in the widget
 // tree, read text, and verify that the values of widget properties are correct.
 //
-// Visit https://flutter.dev/docs/cookbook/testing/widget/introduction for
+// Visit https://flutter.dev/to/widget-testing for
 // more information about Widget testing.
 
 import 'package:flutter/material.dart';

packages/flutter_tools/test/commands.shard/hermetic/build_ipa_test.dart

@@ -1147,7 +1147,7 @@ void main() {
     ));
     expect(
       logger.statusText,
-      contains('To update the settings, please refer to https://docs.flutter.dev/deployment/ios')
+      contains('To update the settings, please refer to https://flutter.dev/to/ios-deploy')
     );
   }, overrides: <Type, Generator>{
     FileSystem: () => fileSystem,
@@ -1206,7 +1206,7 @@ void main() {
     );
     expect(
       logger.statusText,
-      contains('To update the settings, please refer to https://docs.flutter.dev/deployment/ios')
+      contains('To update the settings, please refer to https://flutter.dev/to/ios-deploy')
     );
   }, overrides: <Type, Generator>{
     FileSystem: () => fileSystem,
@@ -1264,7 +1264,7 @@ void main() {
     );
     expect(
       logger.statusText,
-      contains('To update the settings, please refer to https://docs.flutter.dev/deployment/ios'),
+      contains('To update the settings, please refer to https://flutter.dev/to/ios-deploy'),
     );
   }, overrides: <Type, Generator>{
     FileSystem: () => fileSystem,

packages/flutter_tools/test/commands.shard/hermetic/build_linux_test.dart

@@ -141,7 +141,7 @@ void main() {
     expect(createTestCommandRunner(command).run(
       const <String>['build', 'linux', '--no-pub']
     ), throwsToolExit(message: 'No Linux desktop project configured. See '
-      'https://docs.flutter.dev/desktop#add-desktop-support-to-an-existing-flutter-app '
+      'https://flutter.dev/to/add-desktop-support '
       'to learn about adding Linux support to a project.'));
   }, overrides: <Type, Generator>{
     Platform: () => linuxPlatform,

packages/flutter_tools/test/commands.shard/hermetic/build_macos_test.dart

@@ -181,7 +181,7 @@ STDERR STUFF
     expect(createTestCommandRunner(command).run(
       const <String>['build', 'macos', '--no-pub']
     ), throwsToolExit(message: 'No macOS desktop project configured. See '
-      'https://docs.flutter.dev/desktop#add-desktop-support-to-an-existing-flutter-app '
+      'https://flutter.dev/to/add-desktop-support '
       'to learn about adding macOS support to a project.'));
   }, overrides: <Type, Generator>{
     Platform: () => macosPlatform,

packages/flutter_tools/test/commands.shard/hermetic/build_windows_test.dart

@@ -152,7 +152,7 @@ void main() {
     expect(createTestCommandRunner(command).run(
       const <String>['windows', '--no-pub']
     ), throwsToolExit(message: 'No Windows desktop project configured. See '
-      'https://docs.flutter.dev/desktop#add-desktop-support-to-an-existing-flutter-app '
+      'https://flutter.dev/to/add-desktop-support '
       'to learn about adding Windows support to a project.'));
   }, overrides: <Type, Generator>{
     Platform: () => windowsPlatform,

packages/flutter_tools/test/commands.shard/hermetic/http_host_validator_test.dart

@@ -179,7 +179,7 @@ void main() {
           result.messages,
           contains(const ValidationMessage.error(
             'Environment variable PUB_HOSTED_URL does not specify a valid URL: "::Not A Uri::"\n'
-            'Please see https://flutter.dev/community/china for an example of how to use it.',
+            'Please see https://flutter.dev/to/use-mirror-site for an example of how to use it.',
           )),
         );
       });
@@ -204,7 +204,7 @@ void main() {
           result.messages,
           contains(const ValidationMessage.error(
             'Environment variable FLUTTER_STORAGE_BASE_URL does not specify a valid URL: ""\n'
-            'Please see https://flutter.dev/community/china for an example of how to use it.'
+            'Please see https://flutter.dev/to/use-mirror-site for an example of how to use it.'
           )),
         );
       });

packages/flutter_tools/test/commands.shard/permeable/create_test.dart

@@ -3288,7 +3288,7 @@ void main() {
     await runner.run(<String>['create', '--no-pub', '--template=plugin', projectDir.path]);
     expect(logger.errorText, contains(_kNoPlatformsMessage));
     expect(logger.statusText, contains('To add platforms, run `flutter create -t plugin --platforms <platforms> .` under ${globals.fs.path.normalize(globals.fs.path.relative(projectDir.path))}.'));
-    expect(logger.statusText, contains('For more information, see https://flutter.dev/go/plugin-platforms.'));
+    expect(logger.statusText, contains('For more information, see https://flutter.dev/to/pubspec-plugin-platforms.'));
 
   }, overrides: <Type, Generator>{
     FeatureFlags: () => TestFeatureFlags(),
@@ -3304,7 +3304,7 @@ void main() {
     await runner.run(<String>['create', '--no-pub', '--template=plugin_ffi', projectDir.path]);
     expect(logger.errorText, contains(_kNoPlatformsMessage));
     expect(logger.statusText, contains('To add platforms, run `flutter create -t plugin_ffi --platforms <platforms> .` under ${globals.fs.path.normalize(globals.fs.path.relative(projectDir.path))}.'));
-    expect(logger.statusText, contains('For more information, see https://flutter.dev/go/plugin-platforms.'));
+    expect(logger.statusText, contains('For more information, see https://flutter.dev/to/pubspec-plugin-platforms.'));
 
   }, overrides: <Type, Generator>{
     FeatureFlags: () => TestFeatureFlags(),

packages/flutter_tools/test/commands.shard/permeable/upgrade_test.dart

@@ -202,7 +202,7 @@ void main() {
         throwsToolExit(message: 'Unable to upgrade Flutter: Your Flutter checkout '
           'is currently not on a release branch.\n'
           'Use "flutter channel" to switch to an official channel, and retry. '
-          'Alternatively, re-install Flutter by going to https://flutter.dev/docs/get-started/install.'
+          'Alternatively, re-install Flutter by going to https://flutter.dev/setup.'
         ),
       );
       expect(processManager, hasNoRemainingExpectations);
@@ -230,7 +230,7 @@ void main() {
         () async => realCommandRunner.fetchLatestVersion(localVersion: FakeFlutterVersion()),
         throwsToolExit(message: 'Unable to upgrade Flutter: The current Flutter '
           'branch/channel is not tracking any remote repository.\n'
-          'Re-install Flutter by going to https://flutter.dev/docs/get-started/install.'
+          'Re-install Flutter by going to https://flutter.dev/setup.'
         ),
       );
       expect(processManager, hasNoRemainingExpectations);

packages/flutter_tools/test/general.shard/android/android_project_migration_test.dart

@@ -91,7 +91,7 @@ android {
         // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
         applicationId "com.example.asset_sample"
         // You can update the following values to match your application needs.
-        // For more information, see: https://docs.flutter.dev/deployment/android#reviewing-the-gradle-build-configuration.
+        // For more information, see: https://flutter.dev/to/review-gradle-config.
         ''' + minSdkVersionString + r'''
 
         targetSdkVersion flutter.targetSdkVersion

packages/flutter_tools/test/general.shard/android/gradle_errors_test.dart

@@ -698,8 +698,7 @@ assembleProfile
           '│ Following this change, your app will not be available to users running Android SDKs below 21. │\n'
           '│ Consider searching for a version of this plugin that supports these lower versions of the     │\n'
           '│ Android SDK instead.                                                                          │\n'
-          '│ For more information, see:                                                                    │\n'
+          '│ For more information, see: https://flutter.dev/to/review-gradle-config                        │\n'
-          '│ https://docs.flutter.dev/deployment/android#reviewing-the-gradle-build-configuration          │\n'
           '└───────────────────────────────────────────────────────────────────────────────────────────────┘\n'
         )
       );
@@ -1257,7 +1256,7 @@ Could not compile build file '…/example/android/build.gradle'.
       // Ensure the error notes the incompatible Gradle/AGP/Java versions, links to related resources,
       // and a portion of the path to where to change their gradle version.
       expect(testLogger.statusText, contains('Gradle version is incompatible with the Java version'));
-      expect(testLogger.statusText, contains('docs.flutter.dev/go/android-java-gradle-error'));
+      expect(testLogger.statusText, contains('flutter.dev/to/to/java-gradle-incompatibility'));
       expect(testLogger.statusText, contains('gradle-wrapper.properties'));
       expect(testLogger.statusText, contains('https://docs.gradle.org/current/userguide/compatibility.html#java'));
     }, overrides: <Type, Generator>{

packages/flutter_tools/test/general.shard/android/gradle_test.dart

@@ -572,7 +572,7 @@ flutter:
           '      }\n'
           '    }\n'
           '\n'
-          'To learn more, visit https://flutter.dev/go/build-aar\n'
+          'To learn more, visit https://flutter.dev/to/integrate-android-archive\n'
         )
       );
     });
@@ -610,7 +610,7 @@ flutter:
           "      releaseImplementation 'com.mycompany:flutter_release:1.0'\n"
           '    }\n'
           '\n'
-          'To learn more, visit https://flutter.dev/go/build-aar\n'
+          'To learn more, visit https://flutter.dev/to/integrate-android-archive\n'
         )
       );
     });
@@ -648,7 +648,7 @@ flutter:
           "      debugImplementation 'com.mycompany:flutter_debug:1.0'\n"
           '    }\n'
           '\n'
-          'To learn more, visit https://flutter.dev/go/build-aar\n'
+          'To learn more, visit https://flutter.dev/to/integrate-android-archive\n'
         )
       );
     });
@@ -698,7 +698,7 @@ flutter:
           '      }\n'
           '    }\n'
           '\n'
-          'To learn more, visit https://flutter.dev/go/build-aar\n'
+          'To learn more, visit https://flutter.dev/to/integrate-android-archive\n'
         )
       );
     });

packages/flutter_tools/test/general.shard/base/user_messages_test.dart

@@ -15,10 +15,10 @@ void main() {
   final FakePlatform windowsPlatform = FakePlatform(operatingSystem: 'windows');
 
   void checkInstallationURL(_InstallationMessage message) {
-    expect(message(macPlatform), contains('https://flutter.dev/docs/get-started/install/macos#android-setup'));
+    expect(message(macPlatform), contains('https://flutter.dev/to/macos-android-setup'));
-    expect(message(linuxPlatform), contains('https://flutter.dev/docs/get-started/install/linux#android-setup'));
+    expect(message(linuxPlatform), contains('https://flutter.dev/to/linux-android-setup'));
-    expect(message(windowsPlatform), contains('https://flutter.dev/docs/get-started/install/windows#android-setup'));
+    expect(message(windowsPlatform), contains('https://flutter.dev/to/windows-android-setup'));
-    expect(message(FakePlatform(operatingSystem: '')), contains('https://flutter.dev/docs/get-started/install '));
+    expect(message(FakePlatform(operatingSystem: '')), contains('https://flutter.dev/to/android-setup'));
   }
 
   testWithoutContext('Android installation instructions', () {

packages/flutter_tools/test/general.shard/cache_test.dart

@@ -304,7 +304,7 @@ void main() {
       expect(artifact2.didUpdate, false);
       expect(
         logger.errorText,
-        contains('https://flutter.dev/community/china'),
+        contains('https://flutter.dev/to/china-setup'),
       );
     });
 

packages/flutter_tools/test/general.shard/dart_plugin_test.dart

@@ -1183,7 +1183,7 @@ void main() {
             'Invalid plugin specification url_launcher_macos.\n'
             'Cannot find the `flutter.plugin.platforms` key in the `pubspec.yaml` file. '
             'An instruction to format the `pubspec.yaml` can be found here: '
-            'https://flutter.dev/docs/development/packages-and-plugins/developing-packages#plugin-platforms'
+            'https://flutter.dev/to/pubspec-plugin-platforms'
           ),
         );
       }, overrides: <Type, Generator>{

packages/flutter_tools/test/general.shard/flutter_validator_test.dart

@@ -266,7 +266,7 @@ void main() {
         const ValidationMessage.hint(
           'Flutter version 1.0.0 on channel [user-branch] at /sdk/flutter\n'
           'Currently on an unknown channel. Run `flutter channel` to switch to an official channel.\n'
-          "If that doesn't fix the issue, reinstall Flutter by following instructions at https://flutter.dev/docs/get-started/install."
+          "If that doesn't fix the issue, reinstall Flutter by following instructions at https://flutter.dev/setup."
         ),
         const ValidationMessage(
           'If those were intentional, you can disregard the above warnings; however it is '
@@ -299,7 +299,7 @@ void main() {
         const ValidationMessage.hint(
           'Flutter version 0.0.0-unknown on channel beta at /sdk/flutter\n'
           'Cannot resolve current version, possibly due to local changes.\n'
-          'Reinstall Flutter by following instructions at https://flutter.dev/docs/get-started/install.'
+          'Reinstall Flutter by following instructions at https://flutter.dev/setup.'
         ),
         const ValidationMessage(
           'If those were intentional, you can disregard the above warnings; however it is '
@@ -390,7 +390,7 @@ void main() {
         messages: containsAll(<ValidationMessage>[
           const ValidationMessage.hint(
             'Unknown upstream repository.\n'
-            'Reinstall Flutter by following instructions at https://flutter.dev/docs/get-started/install.'
+            'Reinstall Flutter by following instructions at https://flutter.dev/setup.'
           ),
           const ValidationMessage(
             'If those were intentional, you can disregard the above warnings; however it is '

packages/flutter_tools/test/general.shard/intellij/intellij_validator_test.dart

@@ -51,7 +51,7 @@ void main() {
       ValidationMessage.error('Flutter plugin version 0.1.3 - the recommended minimum version is 16.0.0'),
       ValidationMessage('Dart plugin version 162.2485'),
       ValidationMessage('For information about installing plugins, see\n'
-          'https://flutter.dev/intellij-setup/#installing-the-plugins'),
+          'https://flutter.dev/to/intellij-setup'),
     ]);
   });
 

packages/flutter_tools/test/general.shard/macos/cocoapods_test.dart

@@ -571,7 +571,7 @@ end''');
         logger.errorText,
         contains(
           "To build, increase your application's deployment target to at least "
-          '15.0 as described at https://docs.flutter.dev/deployment/ios'
+          '15.0 as described at https://flutter.dev/to/ios-deploy'
         ),
       );
     });
@@ -631,7 +631,7 @@ end''');
         logger.errorText,
         contains(
           "To build, increase your application's deployment target to at least "
-          '15.0 as described at https://docs.flutter.dev/deployment/ios'
+          '15.0 as described at https://flutter.dev/to/ios-deploy'
         ),
       );
     });
@@ -692,7 +692,7 @@ end''');
         logger.errorText,
         contains(
           "To build, increase your application's deployment target to at least "
-          '15.0 as described at https://docs.flutter.dev/deployment/ios'
+          '15.0 as described at https://flutter.dev/to/ios-deploy'
         ),
       );
     });
@@ -756,7 +756,7 @@ end''');
         logger.errorText,
         contains(
           "To build, increase your application's deployment target as "
-          'described at https://docs.flutter.dev/deployment/ios',
+          'described at https://flutter.dev/to/ios-deploy',
         ),
       );
       expect(
@@ -961,7 +961,7 @@ end''');
         logger.errorText,
         contains(
           "To build, increase your application's deployment target to at least "
-          '12.7 as described at https://docs.flutter.dev/deployment/macos'
+          '12.7 as described at https://flutter.dev/to/macos-deploy'
         ),
       );
     });
@@ -1022,7 +1022,7 @@ end''');
         logger.errorText,
         contains(
           "To build, increase your application's deployment target to at least "
-          '12.7 as described at https://docs.flutter.dev/deployment/macos'
+          '12.7 as described at https://flutter.dev/to/macos-deploy'
         ),
       );
     });

packages/flutter_tools/test/host_cross_arch.shard/ios_content_validation_test.dart

@@ -397,7 +397,7 @@ void main() {
         '    ! App icon is set to the default placeholder icon. Replace with unique icons.\n',
         '    ! App icon is using the incorrect size (e.g. Icon-App-20x20@1x.png).\n',
         '    ! Launch image is set to the default placeholder icon. Replace with unique launch image.\n',
-        'To update the settings, please refer to https://docs.flutter.dev/deployment/ios\n',
+        'To update the settings, please refer to https://flutter.dev/to/ios-deploy\n',
       ];
       expect(expectedValidationMessages, unorderedEquals(expectedValidationMessages));
 

packages/flutter_tools/test/integration.shard/android_gradle_deprecated_plugin_apply_test.dart

@@ -144,7 +144,7 @@ android {
         // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
         applicationId "com.example.testapp"
         // You can update the following values to match your application needs.
-        // For more information, see: https://docs.flutter.dev/deployment/android#reviewing-the-build-configuration.
+        // For more information, see: https://flutter.dev/to/review-gradle-config.
         minSdkVersion flutter.minSdkVersion
         targetSdkVersion flutter.targetSdkVersion
         versionCode flutterVersionCode.toInteger()

packages/flutter_tools/test/integration.shard/test_data/migrate_project.dart

@@ -207,10 +207,10 @@ flutter:
     - images/a_dot_ham.jpeg
 
   # An image asset can refer to one or more resolution-specific "variants", see
-  # https://flutter.dev/assets-and-images/#resolution-aware.
+  # https://flutter.dev/to/resolution-aware-images
 
   # For details regarding adding assets from package dependencies, see
-  # https://flutter.dev/assets-and-images/#from-packages
+  # https://flutter.dev/to/asset-from-package
 
   # To add custom fonts to your application, add a fonts section here,
   # in this "flutter" section. Each entry in this list should have a
@@ -230,7 +230,7 @@ flutter:
   #         weight: 700
   #
   # For details regarding fonts from package dependencies,
-  # see https://flutter.dev/custom-fonts/#from-packages
+  # see https://flutter.dev/to/font-from-package
 
 ''';
 }

packages/flutter_tools/test/web.shard/web_driver_service_test.dart

@@ -22,7 +22,7 @@ void main() {
       ),
       dartSdkPath: 'dart',
     );
-    const String link = 'https://flutter.dev/docs/testing/integration-tests#running-in-a-browser';
+    const String link = 'https://flutter.dev/to/integration-test-on-web';
     try {
       await service.startTest(
         'foo.test',