diff --git a/MIGRATION.md b/MIGRATION.md
index 060efde..d3ae7ac 100644
--- a/MIGRATION.md
+++ b/MIGRATION.md
@@ -6,8 +6,31 @@ When you use reducers with a body that uses a link that should return a single r
 
 ### From 1.2 to 1.3
 
-SimpleSchema has been completely removed and it will no longer extend your Collection's schema automatically, therefore,
-if you have configured links you have to manually add them.
+SimpleSchema has been completely removed and it will no longer extend your Collection's schema automatically, therefore, if you have configured links you have to manually add them.
+
+For example the following link:
+
+```js
+Users.addLinks({
+    post: {
+        type: 'one',
+        collection: Posts,
+        field: 'postId'
+    }
+});
+```
+
+Requires the respective field in your Collection's schema:
+
+```js
+// schema for Users
+SimpleSchema({
+    postId: {
+        type: String,
+        optional: true
+    }
+})
+```
 
 The `metadata` link configuration is no longer an object, but a `Boolean`
 
diff --git a/docs/query_options.md b/docs/query_options.md
index d24cfc1..d3ad3d6 100644
--- a/docs/query_options.md
+++ b/docs/query_options.md
@@ -74,7 +74,7 @@ Posts.createQuery({
 })
 ```
 
-The query above will fetch as `comments` only the ones that have been approved and that are linekd with the `post`.
+The query above will fetch as `comments` only the ones that have been approved and that are linked with the `post`.
 
 The `$filter` function shares the same `params` across all collection nodes: