diff --git a/changelog.txt b/changelog.txt
index e69de29b..fd1d1062 100644
--- a/changelog.txt
+++ b/changelog.txt
@@ -0,0 +1,18 @@
+important - Read carefully! There are several breaking changes in this release.
+important - API is now official! Future 1.x.x versions will remain backwards-compatible with the current API contract.
+important - We have a migration guide here: https://firebase.com/docs/web/libraries/angular/guide/migration-guides.html.
+feature - Upgraded Firebase dependency to 2.2.x.
+feature - Enhanced performance of `$bindTo()` (thanks @jamesstalmage).
+feature - Added support for CommonJS (thanks @bendrucker).
+removed - `$firebase` has been removed; see the migration guide for alternatives.
+removed - `$inst()` was removed; use `$ref()` to get to the underlying Firebase reference.
+removed - The previously deprecated ability to pass in credentials to the user management methods of `$firebaseAuth` as individual arguments has been removed in favor of a single credentials argument.
+removed - The previously deprecated `$sendPasswordResetEmail()` method has been removed; use the equivalent `$resetPassword()` method instead.
+changed - `$asArray()` has been replaced by calling the `$firebaseArray` service directly.
+changed - `$asObject()` has been replaced by calling the `$firebaseObject` service directly.
+changed - `$FirebaseArray` renamed to $firebaseArray`.
+changed - `$FirebaseObject` renamed to `$firebaseObject`.
+changed - `$extendFactory()` has been renamed to `$extend()` and has been simplified; see the migration guide for details.
+changed - A warning message is now displayed when trying to sync to array-like data, since this is error-prone.
+changed - Upgraded Angular dependency to 1.3.x and 1.4.x (Angular 1.2.x should still work but it is no longer officially supported).
+fixed - `$value` is now removed when data changes from a primitive to an object with child keys (thanks @jamesstalmage).