diff --git a/package.json b/package.json
index 4929769a1..d4b380764 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "inversify",
-  "version": "3.0.0-beta.3",
+  "version": "3.0.0-rc.1",
   "description": "A powerful and lightweight inversion of control container for JavaScript and Node.js apps powered by TypeScript.",
   "main": "lib/inversify.js",
   "jsnext:main": "es/inversify.js",
diff --git a/wiki/readme.md b/wiki/readme.md
index b0b143294..efaa124d9 100644
--- a/wiki/readme.md
+++ b/wiki/readme.md
@@ -7,7 +7,7 @@ Welcome to the InversifyJS wiki!
 - [Vanilla JavaScript example](https://github.com/inversify/InversifyJS/blob/master/wiki/basic_js_example.md)
 - [Working with module bundlers](https://github.com/inversify/InversifyJS/blob/master/wiki/module_bundlers.md)
 - [ES5 and ES6 support](https://github.com/inversify/InversifyJS/blob/master/wiki/javascript.md)
-- [How to upgrade from 1.x to 2.x](https://github.com/inversify/InversifyJS/blob/master/wiki/upgrade.md)
+- [Upgrade guide](https://github.com/inversify/InversifyJS/blob/master/wiki/upgrade.md)
 
 ### The InversifyJS Features and API
 - [Support for classes](https://github.com/inversify/InversifyJS/blob/master/wiki/classes_as_id.md)
diff --git a/wiki/upgrade.md b/wiki/upgrade.md
index aebc9a158..62427eb91 100644
--- a/wiki/upgrade.md
+++ b/wiki/upgrade.md
@@ -1,6 +1,17 @@
 # How to upgrade from 2.x to 3.x
 
-TODO
+- The 2.x `Kernel` is named `Container` in 3.x
+
+- The 2.x `Kernel` method `getServiceIdentifierAsString` is not a method of `Container`  in 3.x.
+
+- The 2.x `PlanAndResolveArgs` interface is named `NextArgs` in 3.0 and some of its properties have changed.
+
+- The `Provider` signature has been modified.
+
+- In 3.x, `strictNullChecks` is enabled.
+
+- The resolution logic in 2.0 and 3.0 is slightly different in order to support new features like 
+optional dependencies and defaults contextual injections.
 
 # How to upgrade from 1.x to 2.x