diff --git a/pkgs/test_api/CHANGELOG.md b/pkgs/test_api/CHANGELOG.md
index a34b1ab..a5bb5bd 100644
--- a/pkgs/test_api/CHANGELOG.md
+++ b/pkgs/test_api/CHANGELOG.md
@@ -1,3 +1,5 @@
+## 0.4.1-dev
+
 ## 0.4.0
 
 * Add libraries `scaffolding.dart`, and `expect.dart` to allow importing as
diff --git a/pkgs/test_api/lib/src/backend/configuration/retry.dart b/pkgs/test_api/lib/src/backend/configuration/retry.dart
index 681fcce..b813526 100644
--- a/pkgs/test_api/lib/src/backend/configuration/retry.dart
+++ b/pkgs/test_api/lib/src/backend/configuration/retry.dart
@@ -6,13 +6,13 @@
 
 /// An annotation for marking a test suite to be retried.
 ///
-/// A test with retries enabled will be re-run if it fails for a reason
-/// other than [TestFailure].
+/// A suite-level retry configuration will enable retries for every test in the
+/// suite, unless the group or test is configured with a more specific retry.
 @Target({TargetKind.library})
 class Retry {
-  /// The number of times the test will be retried.
+  /// The number of times the tests in the suite will be retried.
   final int count;
 
-  /// Marks a test to be retried.
+  /// Marks all tests in a test suite to be retried.
   const Retry(this.count);
 }
diff --git a/pkgs/test_api/pubspec.yaml b/pkgs/test_api/pubspec.yaml
index 98439eb..922ffba 100644
--- a/pkgs/test_api/pubspec.yaml
+++ b/pkgs/test_api/pubspec.yaml
@@ -1,5 +1,5 @@
 name: test_api
-version: 0.4.0
+version: 0.4.1-dev
 description: A library for writing Dart tests.
 homepage: https://github.com/dart-lang/test/blob/master/pkgs/test_api