diff --git a/content/bartholomew/configuration.md b/content/bartholomew/configuration.md
index 5d5542ded..fcafd94e2 100644
--- a/content/bartholomew/configuration.md
+++ b/content/bartholomew/configuration.md
@@ -47,7 +47,7 @@ It has a few pre-defined fields:
 - base_url: a base URL that templates can use to construct full URLs to content. This can be overridden by setting the `-e BASE_URL="https://example.com"` environment variable for Spin.
 - about: a brief description of the site
 - theme: the name of the theme for the website from the `/themes/` folder
-- index_site_pages: A list of templates that require `site.pages` to be populated.
+- index_site_pages: A list of templates for which Bartholomew will populate `site.pages`. (For more on `site.pages` see [templates](./templates.md#the-site-object).)
 
 ## Extras
 
diff --git a/content/bartholomew/templates.md b/content/bartholomew/templates.md
index 0e7b64503..73318738d 100644
--- a/content/bartholomew/templates.md
+++ b/content/bartholomew/templates.md
@@ -98,7 +98,7 @@ In addition to the `page` object, there is also a `site` object. `site.pages` co
 ```
 
 Note that the `site.pages` array has access to every single document in the `content` folder.
-This part of the API may change in the future, as it does not scale terribly well. 
+See [below](#values-reference) for example values. This part of the API may change in the future, as it does not scale terribly well.
 
 ### The `env` Object