Add migration guide for 4.0

sinonjs · Sep 18, 2017 · dfb9ee6 · dfb9ee6
1 parent 96a124f
commit dfb9ee6
Show file tree

Hide file tree

Showing 2 changed files with 15 additions and 0 deletions.
diff --git a/docs/release-source/release.md b/docs/release-source/release.md
@@ -22,6 +22,7 @@ This page contains the entire Sinon.JS API documentation along with brief    int
 ### Migration guides
 * Migrating from [v1.x to v2.0](./migrating-to-2.0)
 * Migrating from [v2.x to v3.0](./migrating-to-3.0)
+* Migrating from [v3.x to v4.0](./migrating-to-4.0)
 
 ### Compatibility
 

diff --git a/docs/release-source/release/migrating-to-4.0.md b/docs/release-source/release/migrating-to-4.0.md
@@ -0,0 +1,14 @@
+---
+layout: page
+title: Migrating to v4.0 - Sinon.JS
+breadcrumb: migrating to 4.0
+---
+
+As with all `MAJOR` releases in [`semver`](http://semver.org/), there are breaking changes in `sinon@4`.
+This guide will walk you through those changes.
+
+## `sinon.stub(obj, 'nonExistingProperty')` - Throws
+
+Trying to stub a non-existing property will now fail to ensure you are creating
+[less error-prone tests](https://github.com/sinonjs/sinon/pull/1557).
+