diff --git a/README.md b/README.md
index 773f4b1..7b8c220 100644
--- a/README.md
+++ b/README.md
@@ -1,15 +1,21 @@
-#Stormpath is Joining Okta
+# Stormpath is Joining Okta
 We are incredibly excited to announce that [Stormpath is joining forces with Okta](https://stormpath.com/blog/stormpaths-new-path?utm_source=github&utm_medium=readme&utm-campaign=okta-announcement). Please visit [the Migration FAQs](https://stormpath.com/oktaplusstormpath?utm_source=github&utm_medium=readme&utm-campaign=okta-announcement) for a detailed look at what this means for Stormpath users.
 
 We're available to answer all questions at [support@stormpath.com](mailto:support@stormpath.com).
 
-# Stormpath Middleware for ASP.NET [![Slack Status](https://talkstormpath.shipit.xyz/badge.svg)](https://talkstormpath.shipit.xyz) [![NuGet](https://img.shields.io/nuget/v/Stormpath.AspNet.svg)](https://www.nuget.org/packages/Stormpath.AspNet)
+## Migration Guide
+
+The latest version (4.0.0-RC1 and later) of this library supports migrating applications from the Stormpath API to the Okta API. For more information, see the [migration guide](https://github.com/stormpath/stormpath-dotnet-owin-middleware/blob/master/migrating.md).
+
+For a full list of breaking changes, see the [changelog](https://github.com/stormpath/stormpath-dotnet-owin-middleware/blob/master/changelog.md).
+
+# Stormpath Middleware for ASP.NET [![NuGet](https://img.shields.io/nuget/v/Stormpath.AspNet.svg)](https://www.nuget.org/packages/Stormpath.AspNet)
 
 This library makes it incredibly simple to add user authentication features to your ASP.NET application, such as login, signup, authorization, and social login.
 
 [Stormpath](https://stormpath.com) is a User Management API that reduces development time with instant-on, scalable user infrastructure. Stormpath's intuitive API and expert support make it easy for developers to authenticate, manage and secure users and roles in any application.
 
-:bulb: If you're using ASP.NET Core 1.0, grab our [ASP.NET Core library](https://github.com/stormpath/stormpath-aspnetcore) instead.
+:bulb: If you're using ASP.NET Core, grab our [ASP.NET Core library](https://github.com/stormpath/stormpath-aspnetcore) instead.
 
 ## Example Application