When you add a user-facing change to DevTools, please add a release note entry to document this improvement.
This entry should be phrased in the past tense (e.g. “Added XYZ” instead of “Add XYZ”).
Use this format for the entry:
* Created the best feature ever. - [#10000000001](https://github.com/flutter/devtools/pull/10000000001), [#10000000002](https://github.com/flutter/devtools/pull/10000000002), [#10000000003](https://github.com/flutter/devtools/pull/10000000003)
Find other examples in previous notes.
Consider adding an image to the release note entry:
Add the image to the release_notes/images folder,
Reference it in the markdown, right after the release note entry:

Please use DevTools in dark mode when taking screenshots for release notes. We use a dark theme since this is the default theme for DevTools.
When adding images, be cognizant that the images will be rendered in a relatively small window in DevTools, and they should be sized accordingly. A wide aspect ratio is preferred so that the space of the release notes viewer can be used efficiently.
Release notes for DevTools are hosted on the Flutter website. They are indexed at https://docs.flutter.dev/tools/devtools/release-notes.
Before continuing, ensure you have your local environment set up for contributing to the flutter/website repo.
Draft release notes on a local flutter/website branch using the following command:
devtools_tool release-notes -w /Users/me/absolute/path/to/flutter/website
Clean up the drafted notes on your local flutter/website branch and open a PR.
Once you push up your branch to flutter/website and open your PR, wait for the github-actions bot to stage your changes to Firebase. Open the link it comments and navigate to the release notes you want to test. Be sure to add -src.md to the url to get the raw json. The url should look something like:
https://flutter-docs-prod--pr8928-dt-notes-links-b0b33er1.web.app/tools/devtools/release-notes/release-notes-2.24.0-src.md
Copy this url and set _debugReleaseNotesUrl in release_notes.dart to this value.
Run DevTools and the release notes viewer should open with the markdown at the url you provided.
Verify the release notes viewer displays the new release notes as expected. Some issues to watch out for are broken images or ‘include_relative’ lines in the markdown that don't load properly.