diff --git a/docs/changelog.rst b/docs/changelog.rst
index 81bc1989..4b3916d0 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -5,6 +5,7 @@ Changelog
 Changes in dev
 ==============
 
+- Fixed accessing pk on an embedded document
 - Fixed calling a queryset after drop_collection now recreates the collection
 - Add field name to validation exception messages
 - Added UUID field
diff --git a/docs/upgrade.rst b/docs/upgrade.rst
index 671b9301..9151cf3c 100644
--- a/docs/upgrade.rst
+++ b/docs/upgrade.rst
@@ -5,7 +5,8 @@ Upgrading
 0.5 to 0.6
 ==========
 
-TBC
+Embedded Documents - if you had a `pk` field you will have to rename it from `_id`
+to `pk` as pk is no longer a property of Embedded Documents.
 
 0.4 to 0.5
 ===========