2 files changed, 21 insertions, 4 deletions
diff --git a/docs/examples/blogpost.rst b/docs/examples/blogpost.rst
index 36b9d982..be91913d 100644
--- a/docs/examples/blogpost.rst
+++ b/docs/examples/blogpost.rst
@@ -18,9 +18,19 @@ In this example we're working from two related models:
 Creating the resources
 ----------------------
 
-Once we have some existing models there's very little we need to do to create the API.
-Firstly create a resource for each model that defines which fields we want to expose on the model.
-Secondly we map a base view and an instance view for each resource.
+We need to create two resources that we map to our two existing models, in order to describe how the models should be serialized.
+Our resource descriptions will typically go into a module called something like 'resources.py'
+
+``resources.py``
+
+.. include:: ../../examples/blogpost/resources.py
+    :literal:
+
+Creating views for our resources
+--------------------------------
+
+Once we've created the resources there's very little we need to do to create the API.
+For each resource we'll create a base view, and an instance view.
 The generic views :class:`.ListOrCreateModelView` and :class:`.InstanceModelView` provide default operations for listing, creating and updating our models via the API, and also automatically provide input validation using default ModelForms for each model.
 
 ``urls.py``
diff --git a/docs/examples/modelviews.rst b/docs/examples/modelviews.rst
index 7cc78d39..c60c9f24 100644
--- a/docs/examples/modelviews.rst
+++ b/docs/examples/modelviews.rst
@@ -25,7 +25,14 @@ Here's the model we're working from in this example:
 .. include:: ../../examples/modelresourceexample/models.py
     :literal:
 
-To add an API for the model, all we need to do is create a Resource for the model, and map a couple of views to it in our urlconf.
+To add an API for the model, first we need to create a Resource for the model.
+
+``resources.py``
+
+.. include:: ../../examples/modelresourceexample/resources.py
+    :literal:
+
+Then we simply map a couple of views to the Resource in our urlconf.
 
 ``urls.py``