flutter/docs/wiki_archive/User-documentation-index.md
Kevin Chisholm 28033eabc2
[Release] Update release note location (#151931)
**TLDR:** Move the changelog, currently called ["hotfixes to the stable
channel"](https://github.com/flutter/flutter/blob/master/docs/releases/Hotfixes-to-the-Stable-Channel.md),
to the root directory of Flutter/Flutter and rename it to CHANGELOG.md
before the Q3 release cutoff.

This PR accomplishes the following:
1. Renames 'Hotfixes-to-the-stable-channel' to CHANGELOG.md
2. Moves CHANGELOG.md to Flutter/Flutter root.
3. Update references to 'Hotfixes-to-the-stable-channel' to
CHANGELOG.md.

---

#### Background
Flutter has historically kept documentation on wiki pages in the Flutter
repository. Recently, we executed a large-scale migration of our wiki
into a `docs` folder within flutter/flutter.

#### Proposal
I propose relocating the current changelog, which is called ["hotfixes
to the stable
channel"](https://github.com/flutter/flutter/blob/master/docs/releases/Hotfixes-to-the-Stable-Channel.md),
to the root directory of the Flutter/Flutter repository and renaming it
to CHANGELOG.md. This change aims to improve the visibility,
accessibility, and consistency of our documentation processes.

#### Benefits
1. **Unify Dart and Flutter Processes:** This move aligns Flutter’s
changelog management with Dart's practices. As the release manager for
both Dart and Flutter, this unification will streamline the processes
and ensure consistency across projects.

#### Timeline
I would like this proposal **approved or denied before the Q3 release
cutoff** so it may be available within the stable branch.

---

> [!NOTE] 
> This proposal aims to improve our workflow and documentation
standards. I am open to feedback and further discussion on how we can
best implement this change.
2024-07-23 11:53:20 +07:00

58 lines
3.3 KiB
Markdown

<!-- Don't add user documentation to the wiki. User documentation belongs on the web site. -->
<!-- We only have these pages for historical reasons. -->
Flutter's user-facing documentation should all be on the Flutter web site and the API documentation site:
- https://docs.flutter.dev/
- [Release notes](https://docs.flutter.dev/release/release-notes)
- https://api.flutter.dev/
Historically, experimental documentation was sometimes first written on this wiki and later moved to the web site. This is
now discouraged but some of the content created in this way still exists and is listed below.
_Contributors: please consider moving this content to the web site or deleting it if it is no longer applicable!_
## Old documentation
## General
<!-- don't add things here; if you have a new feature, it should be documented on the web site not the wiki -->
- [Apple Silicon support](../platforms/desktop/macos/Developing-with-Flutter-on-Apple-Silicon.md)
- [Bad Builds](../releases/Bad-Builds.md)
- [Binding to native code via FFI](https://flutter.dev/docs/development/platform-integration/c-interop)
- [Data-driven Fixes](../contributing/Data-driven-Fixes.md)
- [Flutter CLI crash reporting](https://docs.flutter.dev/reference/crash-reporting)
- [Flutter CLI custom embedder support](../tool/Using-custom-embedders-with-the-Flutter-CLI.md)
- [Flutter Test Fonts](../contributing/testing/Flutter-Test-Fonts.md)
- [Hybrid Composition](../platforms/Hybrid-Composition.md)
- [IntelliJ - Flutter Setup Tips and Tricks](IntelliJ---Flutter-Setup-Tips-and-Tricks.md)
- [JIT release builds](../engine/JIT-Release-Modes.md)
- [Making animated GIFs of Flutter apps](../contributing/issue_hygiene/Making-animated-GIFs-of-Flutter-apps.md)
- [Multi-device debugging in VS Code](Multi-device-debugging-in-VS-Code.md)
- [Obfuscating Dart Code](https://flutter.dev/docs/deployment/obfuscate)
- [Reduce shader compilation jank using SkSL warm up](https://flutter.dev/docs/perf/rendering/shader)
- [Upgrading Flutter projects from using PlatformMessages to using channels](Upgrading-Flutter-projects-from-using-PlatformMessages-to-using-channels.md)
- [Writing Effective Tests](../contributing/testing/Writing-Effective-Tests.md)
### Android
<!-- don't add things here; user documentation belongs on the web site not the wiki -->
- [Android Fast Start](../tool/Fast-Start.md)
- [Android Platform Views](../platforms/android/Android-Platform-Views.md)
- [How Flutter apps are compiled with Gradle for Android](../platforms/android/How-Flutter-apps-are-compiled-with-Gradle-for-Android.md)
- [Hybrid Composition](../platforms/Hybrid-Composition.md#android)
- [Multidex](../platforms/android/Android-Multidex-support.md)
- [Texture Layer Hybrid Composition](../platforms/android/Texture-Layer-Hybrid-Composition.md)
### iOS
<!-- don't add things here; user documentation belongs on the web site not the wiki -->
- [Hybrid Composition iOS](../platforms/Hybrid-Composition.md#ios)
### Web
<!-- don't add things here; user documentation belongs on the web site not the wiki -->
- [Debugging issues on the Web](../platforms/web/Debugging-issues-on-the-Web.md)
- [Running Flutter Driver tests with Web](../contributing/testing/Running-Flutter-Driver-tests-with-Web.md)
### Release notes
<!-- don't add things here; user documentation belongs on the web site not the wiki -->
- [Hotfixes to the Stable Channel](../../CHANGELOG.md)