Team guide

This is a guide for the Dart team members who are responsible for maintaining dart-lang/site-www.

Dart SDK launch steps

Make these updates

• If doc changes have occurred, update text and examples to reflect the new release.
• Once the stable build is uploaded, update the checksum values in the Dockerfile following the Dart SDK and Node PPA Checksum values instructions.
• Update the What's new and Language evolution pages
• Update the SDK version in src/_data/pkg-vers.json. The SDK version is visible in https://dart.dev/tools/sdk and used in links to API docs (via {{site.data.pkg-vers.SDK.channel}}. For an example, see PR #2462.
• Add a banner to point to the release announcement. For an example of adding the banner, see PR #1234.
• If necessary, update the min SDK in examples' pubspec.yaml files.
• Update the Wikipedia page to display the new release number.

Don't make these updates

• The SDK version used by repo tools. This is controlled by the topmost pubspec.yaml. Unless you're updating the tools, there's no need to update this.

Test a proposed SDK release

1. Verify you have updated the checksums as outlined in the Dart SDK and Node PPA Checksum values instructions.

2. From the root directory, run the build with tests:

   $ make test

Update Wikipedia

Here's how to update the stable release info in the Dart Wikipedia page:

1. In the box at the right of the page, click the pencil next to the Stable release number.
2. Scroll to the bottom of the software version identifier section, and click + add value.
   If it tells you to log into Wikidata, you can do that at the top of the page.
3. In the text field that comes up, enter the release number.
   Example: 2.16.0
4. Click + add qualifier, choose publication date, and add the date.
   Example: 3 February 2022
5. Click + add reference, choose reference URL, and set it to the URL of to the tagged release.
   Example: https://github.com/dart-lang/sdk/releases/tag/2.16.0
6. Now make the new release be displayed:
   1. To the left of the release number is an icon like a tiny scrollbar. Click the top triangle to select it.
   2. In the icon to the left of the previous release number, click the circle to select it.

Note: Some releases (2.13.3, for example), have more fields in the reference, such as retrieved, title, & publication date. I don’t know whether these matter.

History of version updates: https://www.wikidata.org/w/index.php?title=Q406009&action=history