flutter · auto-submit · Sep 16, 2025 · Sep 10, 2025 · Sep 10, 2025 · Sep 10, 2025
diff --git a/.gemini/styleguide.md b/.gemini/styleguide.md
@@ -9,7 +9,7 @@ flutter/flutter repository. It is based on the more comprehensive official
 - Code should follow the guidance and principles described in
   [the Flutter contribution guide](https://github.com/flutter/flutter/blob/main/CONTRIBUTING.md).
 - Code should be tested and follow the guidance described in the [writing effective tests guide](https://github.com/flutter/flutter/blob/main/docs/contributing/testing/Writing-Effective-Tests.md) and the [running and writing tests guide](https://github.com/flutter/flutter/blob/main/docs/contributing/testing/Running-and-writing-tests.md).
-- Changes to the [engine/ directory](https://github.com/flutter/flutter/tree/main/engine) should additionally have appropriate tests as described in [the engine test guidance](https://github.com/flutter/flutter/blob/main/engine/src/flutter/docs/testing/Testing-the-engine.md).
+- Changes to the [engine/ directory](https://github.com/flutter/flutter/tree/main/engine) should additionally have appropriate tests as described in [the engine test guidance](https://github.com/flutter/flutter/blob/main/docs/engine/testing/Testing-the-engine.md).
 - PR descriptions should include the Pre-launch Checklist from
   [the PR template](https://github.com/flutter/flutter/blob/main/.github/PULL_REQUEST_TEMPLATE.md),
   with all of the steps completed.
@@ -81,4 +81,4 @@ For more detailed guidance, refer to the following documents:
 - [The Flutter contribution guide](https://github.com/flutter/flutter/blob/main/CONTRIBUTING.md)
 - [Writing effective tests guide](https://github.com/flutter/flutter/blob/main/docs/contributing/testing/Writing-Effective-Tests.md)
 - [Running and writing tests guide](https://github.com/flutter/flutter/blob/main/docs/contributing/testing/Running-and-writing-tests.md)
-- [Engine testing guide](https://github.com/flutter/flutter/blob/main/engine/src/flutter/docs/testing/Testing-the-engine.md)
+- [Engine testing guide](https://github.com/flutter/flutter/blob/main/docs/engine/testing/Testing-the-engine.md)
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -106,7 +106,7 @@ that describe these methodologies. The following list is ordered: you
 are strongly recommended to go through these documents in the order
 presented.
 
-1. [Setting up your engine development environment](./engine/src/flutter/docs/contributing/Setting-up-the-Engine-development-environment.md),
+1. [Setting up your engine development environment](./docs/engine/contributing/Setting-up-the-Engine-development-environment.md),
    which describes the steps you need to configure your computer to
    work on Flutter's engine. If you only want to write code for the
    Flutter framework, you can skip this step. Flutter's engine mainly

diff --git a/docs/README.md b/docs/README.md
@@ -14,7 +14,7 @@ If you intend to contribute to Flutter, welcome! You are encouraged to start wit
 * [Cherrypick process](./releases/Flutter-Cherrypick-Process.md)
 * [Closing issues](./contributing/issue_hygiene/README.md#closing-issues)
 * [Dashboards](./infra/Dashboards.md)
-* [Debugging a broken engine autoroll](../engine/src/flutter/docs/Debugging-the-engine.md#bisecting-a-roll-failure)
+* [Debugging a broken engine autoroll](../docs/engine/Debugging-the-engine.md#bisecting-a-roll-failure)
 * [Deprecations](./contributing/Tree-hygiene.md#deprecations)
 * [Design documents](./contributing/Design-Documents.md)
 * [Discord](./contributing/Chat.md)
@@ -31,7 +31,7 @@ If you intend to contribute to Flutter, welcome! You are encouraged to start wit
 * [Style guide for Flutter repo](./contributing/Style-guide-for-Flutter-repo.md)
 * [Submitting code, process for](./contributing/Tree-hygiene.md#overview)
 * [Support levels, definitions of](./about/Values.md#support)
-* [Symbolicating stack traces](../engine/src/flutter/docs/Crashes.md)
+* [Symbolicating stack traces](../docs/engine/Crashes.md)
 * [Threading in the Engine](./about/The-Engine-architecture.md#threading)
 * [When will my bug be fixed?](./contributing/issue_hygiene/README.md#when-will-my-bug-be-fixed)
 * [Security best practices](./infra/Security.md#best-practices)
diff --git a/docs/about/The-Engine-architecture.md b/docs/about/The-Engine-architecture.md
@@ -14,7 +14,7 @@ Flutter Engine sits in this stack, highlights API boundaries, and identifies the
 repositories where the individual pieces live. The legend below clarifies some
 of the terminology commonly used to describe the pieces of a Flutter app.
 
-<img src="https://raw.githubusercontent.com/flutter/flutter/main/engine/src/flutter/docs/app_anatomy.svg?sanitize=true" alt="Flutter Architecture Diagram" width="40%"/>
+<img src="https://raw.githubusercontent.com/flutter/flutter/main/docs/engine/app_anatomy.svg?sanitize=true" alt="Flutter Architecture Diagram" width="40%"/>
 
 #### Dart App
 
@@ -70,7 +70,7 @@ library called `dart:ui` to provide low-level access to Skia features and the
 shell. The shells can also communicate directly to Dart code via [Platform
 Channels](https://flutter.io/platform-channels/) which bypass the engine.
 
-![Flutter Architecture Diagram](https://github.com/flutter/flutter/tree/main/engine/src/flutter/docs/flutter_overview.svg?sanitize=true)
+![Flutter Architecture Diagram](https://github.com/flutter/flutter/tree/main/docs/engine/flutter_overview.svg?sanitize=true)
 
 ## Threading
 

diff --git a/docs/contributing/Setting-up-the-Framework-development-environment.md b/docs/contributing/Setting-up-the-Framework-development-environment.md
@@ -13,7 +13,7 @@
    Verify that `adb` is in your [PATH](https://en.wikipedia.org/wiki/PATH_(variable)) (that `which adb` prints sensible output).
 
    If you're
-   [also working on the Flutter engine](../../engine/src/flutter/docs/contributing/Setting-up-the-Engine-development-environment.md),
+   [also working on the Flutter engine](../../docs/engine/contributing/Setting-up-the-Engine-development-environment.md),
    you can use the copy of the Android platform tools in
    `.../engine/src/third_party/android_tools/sdk/platform-tools`.
 

diff --git a/docs/contributing/Tree-hygiene.md b/docs/contributing/Tree-hygiene.md
@@ -152,7 +152,7 @@ feel empowered to ask for tests.
 ## Using git
 
 Assuming your environment has been configured according to the instructions in
-[Setting up the Engine development environment](../../engine/src/flutter/docs/contributing/Setting-up-the-Engine-development-environment.md),
+[Setting up the Engine development environment](../../docs/engine/contributing/Setting-up-the-Engine-development-environment.md),
 [Setting up the Framework development environment](Setting-up-the-Framework-development-environment.md), or
 [Setting up the Packages development environment](../ecosystem/contributing/Setting-up-the-Packages-development-environment.md),
 follow these steps to start working on a patch:

diff --git a/docs/contributing/testing/Running-and-writing-tests.md b/docs/contributing/testing/Running-and-writing-tests.md
@@ -47,7 +47,7 @@ runs them, run `dart dev/bots/test.dart` and `dart --enable-asserts dev/bots/ana
 
 ### Locally built engines
 
-If you've built your own flutter engine (see [Setting up the Engine development environment](../../../engine/src/flutter/docs/contributing/Setting-up-the-Engine-development-environment.md)), you
+If you've built your own flutter engine (see [Setting up the Engine development environment](../../../docs/engine/contributing/Setting-up-the-Engine-development-environment.md)), you
 can pass `--local-engine` to change what flutter shell `flutter test` uses. For example,
 if you built an engine in the `out/host_debug_unopt` directory, you can use:
 
@@ -120,8 +120,8 @@ The following is an example of what running the local engine command might look
 
 The above command would use the local Flutter engine located at `/Users/myname/flutter/engine` to execute the `external_ui_integration_test` test on an Android emulator, which is why the `android_debug_unopt_x86` version of the engine is used.
 
-Note that some tests may require `profile` mode instead of `debug` mode when running with local engine. Make sure to pass in the correct local engine. See [Compiling the engine](../../../engine/src/flutter/docs/contributing/Compiling-the-engine.md) for more details.
+Note that some tests may require `profile` mode instead of `debug` mode when running with local engine. Make sure to pass in the correct local engine. See [Compiling the engine](../../../docs/engine/contributing/Compiling-the-engine.md) for more details.
 
 ## For the engine
 
-See the [Testing the engine](../../../engine/src/flutter/docs/testing/Testing-the-engine.md) wiki.
+See the [Testing the engine](../../../docs/engine/testing/Testing-the-engine.md) wiki.
diff --git a/engine/src/flutter/docs/Crashes.md → docs/engine/Crashes.md b/engine/src/flutter/docs/Crashes.md → docs/engine/Crashes.md
diff --git a/...r/docs/Custom-Flutter-Engine-Embedders.md → ...engine/Custom-Flutter-Engine-Embedders.md b/...r/docs/Custom-Flutter-Engine-Embedders.md → ...engine/Custom-Flutter-Engine-Embedders.md
diff --git a/...m-Flutter-Engine-Embedding-in-AOT-Mode.md → ...m-Flutter-Engine-Embedding-in-AOT-Mode.md b/...m-Flutter-Engine-Embedding-in-AOT-Mode.md → ...m-Flutter-Engine-Embedding-in-AOT-Mode.md
diff --git a/.../src/flutter/docs/Debugging-the-engine.md → docs/engine/Debugging-the-engine.md b/.../src/flutter/docs/Debugging-the-engine.md → docs/engine/Debugging-the-engine.md
@@ -87,7 +87,7 @@ You can also set a breakpoint directly with [lldb](https://lldb.llvm.org/tutoria
 
 ## Debugging Android builds with gdb
 
-See https://github.com/flutter/flutter/blob/master/engine/src/flutter/sky/tools/flutter_gdb
+See https://github.com/flutter/flutter/blob/main/engine/src/flutter/sky/tools/flutter_gdb
 
 ## Debugging native engine code on Android with Android Studio
 

diff --git a/...src/flutter/docs/Engine-disk-footprint.md → docs/engine/Engine-disk-footprint.md b/...src/flutter/docs/Engine-disk-footprint.md → docs/engine/Engine-disk-footprint.md
diff --git a/...e-specific-Service-Protocol-extensions.md → ...e-specific-Service-Protocol-extensions.md b/...e-specific-Service-Protocol-extensions.md → ...e-specific-Service-Protocol-extensions.md
diff --git a/engine/src/flutter/docs/Flutter's-modes.md → docs/engine/Flutter's-modes.md b/engine/src/flutter/docs/Flutter's-modes.md → docs/engine/Flutter's-modes.md
diff --git a/...s/Flutter-engine-operation-in-AOT-Mode.md → ...e/Flutter-engine-operation-in-AOT-Mode.md b/...s/Flutter-engine-operation-in-AOT-Mode.md → ...e/Flutter-engine-operation-in-AOT-Mode.md
diff --git a/...ocs/Image-Codecs-in-the-Flutter-Engine.md → ...ine/Image-Codecs-in-the-Flutter-Engine.md b/...ocs/Image-Codecs-in-the-Flutter-Engine.md → ...ine/Image-Codecs-in-the-Flutter-Engine.md
diff --git a/...c/flutter/docs/Life-of-a-Flutter-Frame.md → docs/engine/Life-of-a-Flutter-Frame.md b/...c/flutter/docs/Life-of-a-Flutter-Frame.md → docs/engine/Life-of-a-Flutter-Frame.md
diff --git a/engine/src/flutter/docs/README.md → docs/engine/README.md b/engine/src/flutter/docs/README.md → docs/engine/README.md
@@ -1,6 +1,6 @@
 This is an index of team-facing documentation for the [flutter/engine team](https://github.com/flutter/flutter/tree/main/engine).
 
-- [Accessibility on Windows](https://github.com/flutter/flutter/blob/master/docs/platforms/desktop/windows/Accessibility-on-Windows.md)
+- [Accessibility on Windows](https://github.com/flutter/flutter/blob/main/docs/platforms/desktop/windows/Accessibility-on-Windows.md)
 - [Code signing metadata](./release/Code-signing-metadata.md) for engine binaries
 - [Compiling the engine](./contributing/Compiling-the-engine.md)
 - [Comparing AOT Snapshot Sizes](./benchmarks/Comparing-AOT-Snapshot-Sizes.md)
@@ -9,7 +9,7 @@ This is an index of team-facing documentation for the [flutter/engine team](http
 - [Custom Flutter Engine Embedding in AOT Mode](./Custom-Flutter-Engine-Embedding-in-AOT-Mode.md)
 - [Debugging the engine](./Debugging-the-engine.md)
 - [Flutter engine operation in AOT Mode](./Flutter-engine-operation-in-AOT-Mode.md)
-- [Flutter Test Fonts](https://github.com/flutter/flutter/blob/master/docs/contributing/testing/Flutter-Test-Fonts.md)
+- [Flutter Test Fonts](https://github.com/flutter/flutter/blob/main/docs/contributing/testing/Flutter-Test-Fonts.md)
 - [Flutter's modes](./Flutter's-modes.md)
 - [Engine Clang Tidy Linter](./ci/Engine-Clang-Tidy-Linter.md)
 - [Engine disk footprint](./Engine-disk-footprint.md)
@@ -18,12 +18,12 @@ This is an index of team-facing documentation for the [flutter/engine team](http
 - [Image Codecs in the Flutter Engine](Image-Codecs-in-the-Flutter-Engine.md)
 - [Impeller](./impeller/README.md) documentation index
 - [Life of a Flutter Frame](Life-of-a-Flutter-Frame.md)
-- [Resolving common build failures](https://github.com/flutter/flutter/blob/master/docs/platforms/android/Resolving-common-build-failures.md)
+- [Resolving common build failures](https://github.com/flutter/flutter/blob/main/docs/platforms/android/Resolving-common-build-failures.md)
 - [Setting up the Engine development environment](./contributing/Setting-up-the-Engine-development-environment.md)
 - [Supporting legacy platforms](Supporting-legacy-platforms.md)
-- [Testing Android Changes in the Devicelab on an Emulator](https://github.com/flutter/flutter/blob/master/docs/platforms/android/Testing-Android-Changes-in-the-Devicelab-on-an-Emulator.md)
+- [Testing Android Changes in the Devicelab on an Emulator](https://github.com/flutter/flutter/blob/main/docs/platforms/android/Testing-Android-Changes-in-the-Devicelab-on-an-Emulator.md)
 - [Testing the engine](./testing/Testing-the-engine.md)
-- [The Engine architecture](https://github.com/flutter/flutter/blob/master/docs/about/The-Engine-architecture.md)
-- [Upgrading Engine's Android API version](https://github.com/flutter/flutter/blob/master/docs/platforms/android/Upgrading-Engine's-Android-API-version.md)
+- [The Engine architecture](https://github.com/flutter/flutter/blob/main/docs/about/The-Engine-architecture.md)
+- [Upgrading Engine's Android API version](https://github.com/flutter/flutter/blob/main/docs/platforms/android/Upgrading-Engine's-Android-API-version.md)
 - [Using the Dart Development Service (DDS) and Flutter DevTools with a custom Flutter Engine Embedding](./Using-the-Dart-Development-Service-(DDS)-and-Flutter-DevTools-with-a-custom-Flutter-Engine-Embedding.md)
 - [Using Sanitizers with the Flutter Engine](./Using-Sanitizers-with-the-Flutter-Engine.md)
diff --git a/...utter/docs/Supporting-legacy-platforms.md → docs/engine/Supporting-legacy-platforms.md b/...utter/docs/Supporting-legacy-platforms.md → docs/engine/Supporting-legacy-platforms.md
diff --git a/...ing-Sanitizers-with-the-Flutter-Engine.md → ...ing-Sanitizers-with-the-Flutter-Engine.md b/...ing-Sanitizers-with-the-Flutter-Engine.md → ...ing-Sanitizers-with-the-Flutter-Engine.md
diff --git a/...with-a-custom-Flutter-Engine-Embedding.md → ...with-a-custom-Flutter-Engine-Embedding.md b/...with-a-custom-Flutter-Engine-Embedding.md → ...with-a-custom-Flutter-Engine-Embedding.md
diff --git a/engine/src/flutter/docs/app_anatomy.svg → docs/engine/app_anatomy.svg b/engine/src/flutter/docs/app_anatomy.svg → docs/engine/app_anatomy.svg
diff --git a/...enchmarks/Comparing-AOT-Snapshot-Sizes.md → ...enchmarks/Comparing-AOT-Snapshot-Sizes.md b/...enchmarks/Comparing-AOT-Snapshot-Sizes.md → ...enchmarks/Comparing-AOT-Snapshot-Sizes.md
diff --git a/...utter/docs/ci/Engine-Clang-Tidy-Linter.md → docs/engine/ci/Engine-Clang-Tidy-Linter.md b/...utter/docs/ci/Engine-Clang-Tidy-Linter.md → docs/engine/ci/Engine-Clang-Tidy-Linter.md
diff --git a/...ci/Engine-pre-submits-and-post-submits.md → ...ci/Engine-pre-submits-and-post-submits.md b/...ci/Engine-pre-submits-and-post-submits.md → ...ci/Engine-pre-submits-and-post-submits.md