Skip to content

Conversation

@itsjustkevin
Copy link
Contributor

@itsjustkevin itsjustkevin commented Jun 6, 2024

TLDR: Move the changelog, currently called "hotfixes to the stable channel", to the root directory of Flutter/Flutter and rename it to CHANGELOG.md before the Q3 release cutoff.


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", 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.

@itsjustkevin itsjustkevin changed the title Changelog move [Proposal] Relocate and Rename Changelog to CHANGELOG.md in Flutter/Flutter Repository Jun 6, 2024
Copy link
Contributor

@Piinks Piinks left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Totally on board with this, couple things..

  • let me land #149544 first which updates all links referencing wiki pages in flutter/flutter
  • then we'll need to update any references to Hotfixes-to-the-Stable-Channel with a find and replace to point to the new file
  • and update the original wiki page that currently points to where it is now

@itsjustkevin
Copy link
Contributor Author

Thanks @Piinks I can volunteer to do some of the heavy lifting in this task once your PR has landed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants