updated docs to list pagination_dir configuration option

source/docs/configuring/index.markdown

@@ -55,6 +55,7 @@ These configurations are used by Jekyll and Plugins. If you're not familiar with
 
     pygments:           # Toggle python pygments syntax highlighting
     paginate:           # Posts per page on the blog index
+    pagination_dir:     # Directory base for pagination URLs eg. /blog/page/2/
     recent_posts:       # Number of recent posts to appear in the sidebar
 
     default_asides:     # Configure what shows up in the sidebar and in what order
@@ -65,9 +66,8 @@ These configurations are used by Jekyll and Plugins. If you're not familiar with
 
 If you want to change the way permalinks are written for your blog posts, see [Jekyll's permalink docs](https://github.com/mojombo/jekyll/wiki/Permalinks).
 
-**Note:** Jekyll has a `baseurl` config which adds a redirect for Jekyll's WEBrick server for subdirectory support. This works fine if you want
-to use the WEBrick server, but for any other web service you have to add support for the redirect. Instead, Octopress uses the `root` config and offers a rake task
-`set_root_dir[/some/directory]` which moves the output directory into a subdirectory and updates configurations. [(see Deploying Octopress)](/docs/deploying).
+**Note:** Jekyll has a `baseurl` config which offers mock subdirectory publishing support by adding a redirect to Jekyll's WEBrick server. **Please don't use this.**
+If you want to publish your site to a subdirectory, [(see Deploying Octopress to a Subdirectory)](/docs/deploying/#deploy_subdir).
 
 <h3 id="third_party">3rd Party Settings</h3>
 These third party integrations are already set up for you. Simply fill in the configurations and they'll be added to your site.