diff --git a/CHANGELOG.md b/CHANGELOG.md
index fc74b07..7ef64cf 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,26 @@
+## 3.0.0-beta
+
+* This release is the first 3.0.0 release featuring the new Mockito 3 API. The
+  README has been updated, and an [upgrading-to-mockito-3] doc has been added
+  to help users upgrade. Here's a quick rundown:
+
+  ```dart
+  // Old API:
+  when(obj.fn(typed(any)))...
+  // New API:
+  when(obj.fn(any))...
+
+  // Old API:
+  when(obj.fn(foo: typed(any, named: 'foo')))...
+  // New API:
+  when(obj.fn(foo: anyNamed('foo')))...
+
+  // Old API:
+  when(obj.fn(foo: typed(null, named: 'foo')))...
+  // New API:
+  when(obj.fn(foo: argThat(isNull, named: 'foo')))...
+  ```
+
 ## 3.0.0-alpha+5
 
 * Fix compatibility with new [noSuchMethod Forwarding] feature of Dart 2. This
diff --git a/pubspec.yaml b/pubspec.yaml
index f849689..74076ca 100644
--- a/pubspec.yaml
+++ b/pubspec.yaml
@@ -1,5 +1,5 @@
 name: mockito
-version: 3.0.0-alpha+3
+version: 3.0.0-beta
 authors:
   - Dmitriy Fibulwinter <fibulwinter@gmail.com>
   - Dart Team <misc@dartlang.org>