--- a/CHANGELOG.rst	Thu Feb 15 22:27:11 2018 -0800
+++ b/CHANGELOG.rst	Thu Feb 15 22:29:40 2018 -0800
@@ -10,13 +10,42 @@
 
 
 ==================================
-1. PieCrust 3.0.0 (2018-02-13)
+1. PieCrust 3.0.1 (2018-02-15)
 ==================================
 
 
 1.0 Commands
 ----------------------
 
+* serve: Fix debug rendering for page iterators.
+* serve: Show debug info, report errors when debug info isn't available.
+* sources: Fix some invalid relationship name.
+
+1.1 Core
+----------------------
+
+* data: Fix debug rendering of the blog data provider.
+* data: Fix debug rendering of the family data.
+
+1.3 Project
+----------------------
+
+* cm: Ignore documentation counter.
+* docs: Add information about common file-system sources' configurations.
+* docs: Add some information about migrating from v2 to v3.
+* docs: Cosmetic improvements to the navigation bar.
+* docs: Fix default formatter.
+* docs: Make the "code" section show up correctly in navigation.
+* docs: Tweak CSS style for block quotes.
+
+==================================
+2. PieCrust 3.0.0 (2018-02-13)
+==================================
+
+
+2.0 Commands
+----------------------
+
 * admin: Handle multiple photo uploads in the micropub endpoint.
 * admin: Make tumbnails when posting photos, commit to SCM.
 * admin: Upgrade Bootstrap, switch icons to Open-Iconic, remove Bower.
@@ -53,7 +82,7 @@
 * sources: Fix ordering and filename confusion in the "ordered" source.
 * sources: Improve error message when trying to get children pages on a group.
 
-1.1 Core
+2.1 Core
 ----------------------
 
 * data: Add new properties and folder support to the ``family`` data endpoint.
@@ -67,18 +96,20 @@
 * internal: Remove unused parameter.
 * templating: Add Inukshuk template engine.
 
-1.3 Project
+2.3 Project
 ----------------------
 
 * cm: Add Python 3.6 to Travis-CI.
 * cm: Bump Inukshuk to ``0.1.2`` , regenerate ``requirements.txt`` .
 * cm: Bump cache version ahead of v3 release.
 * cm: Include Bootstrap dependencies in ``package.json`` .
+* cm: Regenerate the CHANGELOG.
 * cm: Separate ``requirements`` from what ``setup.py`` wants.
 * cm: Update Inukshuk for Python 3.4 compatibility.
 * cm: Update ``garcon`` 's documentation script to work with latest toolchain.
 * cm: Upgrade Jinja2 to ``2.10`` , remove ``dev-requirements.txt`` .
 * cm: Upgrade invoke, add hoedown to requirements.
+* cm: Upgrade release script.
 * docs: Style tweaks.
 * docs: Update documentation on sources and pipelines.
 * docs: Upgrade to Bootstrap 4 and Sass.
@@ -88,7 +119,7 @@
 * tests: LOL
 * tests: Prevent conflicts in later ``pytest`` versions.
 
-1.4 Miscellaneous
+2.4 Miscellaneous
 ----------------------
 
 * formatters: Remove Hoedown formatter, split it off to a pluging.
@@ -96,11 +127,11 @@
 * sass: Make sure ``load_paths`` are relative to the website's root.
 
 ==================================
-2. PieCrust 2.1.2 (2017-11-21)
+3. PieCrust 2.1.2 (2017-11-21)
 ==================================
 
 
-2.0 Commands
+3.0 Commands
 ----------------------
 
 * admin: Regenerate FoodTruck assets.
@@ -111,18 +142,18 @@
 * prepare: Fix a crash when preparing a new post.
 * sources: Respect the "abort source use" setting when iterating on a source.
 
-2.1 Core
+3.1 Core
 ----------------------
 
 * data: Optimize page data so cheapest accessors are tried first.
 * pagination: Fix bad bug where all pages triggered pagination.
 
-2.2 Bugfixes
+3.2 Bugfixes
 ----------------------
 
 * bug: Fix crash on Python 3.6.
 
-2.3 Project
+3.3 Project
 ----------------------
 
 * cm: Fix crashes when page assets deployment fails.
@@ -135,18 +166,18 @@
 * cm: Upgrade Garcon tasks to the latest PyInvoke version.
 * tests: Fix non-determinism in linker tests.
 
-2.4 Miscellaneous
+3.4 Miscellaneous
 ----------------------
 
 * fix: Compatibility for Python 3.4.
 * showrecords: Sort records by name.
 
 ==================================
-3. PieCrust 2.1.0 (2017-10-29)
+4. PieCrust 2.1.0 (2017-10-29)
 ==================================
 
 
-3.0 Commands
+4.0 Commands
 ----------------------
 
 * admin: Add a "rebake preview assets" button to the dashboard.
@@ -220,7 +251,7 @@
 * sources: Posts source accepts more arguments for creating a post.
 * themes: Allow keeping local overrides when copying a theme locally.
 
-3.1 Core
+4.1 Core
 ----------------------
 
 * config: Better generate route function names to prevent collisions.
@@ -252,7 +283,7 @@
 * routing: Properly order routes by pass when matching them to the request.
 * templating: Template engines can now load extensions directly from plugins.
 
-3.3 Project
+4.3 Project
 ----------------------
 
 * cm: Regenerate the CHANGELOG.
@@ -260,7 +291,7 @@
 * tests: Big push to get the tests to pass again.
 * tests: First pass on making unit tests work again.
 
-3.4 Miscellaneous
+4.4 Miscellaneous
 ----------------------
 
 * assets: Fix bug in assetor.
@@ -293,11 +324,11 @@
 * wsgi: Add admin panel to WSGI helpers.
 
 ==================================
-4. PieCrust 2.0.0 (2017-02-19)
+5. PieCrust 2.0.0 (2017-02-19)
 ==================================
 
 
-4.0 Commands
+5.0 Commands
 ----------------------
 
 * admin: Add ability to upload page assets.
@@ -309,7 +340,7 @@
 * bake: Show bake stats in descending order of time.
 * showrecord: Add ``show-manifest`` argument.
 
-4.1 Core
+5.1 Core
 ----------------------
 
 * config: Cleanup config loading code. Add support for a ``local.yml`` config.
@@ -322,12 +353,12 @@
 * rendering: Separate performance timers for renering segments and layouts.
 * templating: Put the routing functions in the data, not the template engine.
 
-4.2 Bugfixes
+5.2 Bugfixes
 ----------------------
 
 * bug: Fix crashes for commands run outside of a website.
 
-4.3 Project
+5.3 Project
 ----------------------
 
 * cm: Add setup.cfg file for flake8.
@@ -343,7 +374,7 @@
 * docs: Repair some broken links
 * tests: Fix for time comparisons.
 
-4.4 Miscellaneous
+5.4 Miscellaneous
 ----------------------
 
 * Allow PageSource to provide a custom assetor
@@ -360,11 +391,11 @@
 * assets: Fix crash when a page doesn't have assets.
 
 ==================================
-5. PieCrust 2.0.0rc2 (2016-09-07)
+6. PieCrust 2.0.0rc2 (2016-09-07)
 ==================================
 
 
-5.0 Commands
+6.0 Commands
 ----------------------
 
 * admin: Correctly flush loggers before exiting.
@@ -391,7 +422,7 @@
 * showrecord: Fix some crashes and incorrect information.
 * themes: No parameters shoudl make the help text show up.
 
-5.1 Core
+6.1 Core
 ----------------------
 
 * config: Fix how we parse the root URL to allow for absolute and user URLs.
@@ -405,12 +436,12 @@
 * routing: Simplify how route functions are declared and handled.
 * routing: Simplify how routes are defined.
 
-5.2 Bugfixes
+6.2 Bugfixes
 ----------------------
 
 * bug: Fix possible crash with overlapping pages.
 
-5.3 Project
+6.3 Project
 ----------------------
 
 * cm: Add a "Bugfixes" section to the CHANGELOG and order things alphabetically.
@@ -428,11 +459,11 @@
 * tests: Try and finally fix the time-based tests.
 
 ==================================
-6. PieCrust 2.0.0rc1 (2016-06-09)
+7. PieCrust 2.0.0rc1 (2016-06-09)
 ==================================
 
 
-6.0 Commands
+7.0 Commands
 ----------------------
 
 * admin: Add support for Git source-control.
@@ -469,7 +500,7 @@
 * themes: Expand ``~`` paths, fix error message.
 * themes: Simplify ``themes`` command.
 
-6.1 Core
+7.1 Core
 ----------------------
 
 * data: Make the blog provider give usable data to the year archive routes.
@@ -505,12 +536,12 @@
 * templating: Make the 'categories' taxonomy use a 'pccaturl' function again.
 * templating: Use HTTPS URLs for a couple things.
 
-6.2 Bugfixes
+7.2 Bugfixes
 ----------------------
 
 * bug: Also look for format changes when determining if a page needs parsing.
 
-6.3 Project
+7.3 Project
 ----------------------
 
 * cm: Add AppVeyor support.
@@ -541,29 +572,29 @@
 * tests: Improve failure reporting.
 * tests: the ``PageBaker`` now needs to be shutdown.
 
-6.4 Miscellaneous
+7.4 Miscellaneous
 ----------------------
 
 * Fix 404 broken link
 * jinja: Add ``md5`` filter.
 
 ==================================
-7. PieCrust 2.0.0b5 (2016-02-16)
+8. PieCrust 2.0.0b5 (2016-02-16)
 ==================================
 
 
-7.0 Commands
+8.0 Commands
 ----------------------
 
 * admin: Don't require ``bcrypt`` for running FoodTruck with ``chef`` .
 * admin: Remove settings view.
 
-7.1 Core
+8.1 Core
 ----------------------
 
 * internal: Remove SyntaxWarning from MacOS wrappers.
 
-7.3 Project
+8.3 Project
 ----------------------
 
 * cm: Exclude the correct directories from vim-gutentags.
@@ -581,11 +612,11 @@
 * cm: Update the node modules before building the documentation.
 
 ==================================
-8. PieCrust 2.0.0b4 (2016-02-09)
+9. PieCrust 2.0.0b4 (2016-02-09)
 ==================================
 
 
-8.0 Commands
+9.0 Commands
 ----------------------
 
 * admin: Ability to configure SCM stuff per site.
@@ -643,7 +674,7 @@
 * sources: Add code to support "interactive" metadata acquisition.
 * sources: Add method to get a page factory from a path.
 
-8.1 Core
+9.1 Core
 ----------------------
 
 * cli: Add ``--no-color`` option.
@@ -657,13 +688,13 @@
 * internal: Rename ``raw_content`` to ``segments`` since it's what it is.
 * internal: Some fixes to the new app configuration.
 
-8.2 Bugfixes
+9.2 Bugfixes
 ----------------------
 
 * bug: Correctly handle root URLs with special characters.
 * bug: Fix a crash when some errors occur during page rendering.
 
-8.3 Project
+9.3 Project
 ----------------------
 
 * cm: Add requirements for FoodTruck.
@@ -689,24 +720,24 @@
 * tests: Print more information when a bake test fails to find an output file.
 
 ==================================
-9. PieCrust 2.0.0b3 (2015-08-01)
+10. PieCrust 2.0.0b3 (2015-08-01)
 ==================================
 
 
-9.0 Commands
+10.0 Commands
 ----------------------
 
 * import: Add some debug logging.
 * import: Correctly convert unicode characters in site configuration.
 * import: Fix the PieCrust 1 importer.
 
-9.1 Core
+10.1 Core
 ----------------------
 
 * internal: Fix a severe bug with the file-system wrappers on OSX.
 * templating: Make more date functions accept 'now' as an input.
 
-9.3 Project
+10.3 Project
 ----------------------
 
 * cm: Add a Gutentags config file for ``ctags`` generation.
@@ -716,26 +747,26 @@
 * tests: Check accented characters work in configurations.
 
 ==================================
-10. PieCrust 2.0.0b2 (2015-07-29)
+11. PieCrust 2.0.0b2 (2015-07-29)
 ==================================
 
 
-10.0 Commands
+11.0 Commands
 ----------------------
 
 * prepare: More help about scaffolding.
 
-10.2 Bugfixes
+11.2 Bugfixes
 ----------------------
 
 * bug: Fix crash running ``chef help scaffolding`` outside of a website.
 
 ==================================
-11. PieCrust 2.0.0b1 (2015-07-29)
+12. PieCrust 2.0.0b1 (2015-07-29)
 ==================================
 
 
-11.0 Commands
+12.0 Commands
 ----------------------
 
 * bake: Add a processor to generate a Pygments style CSS file.
@@ -756,7 +787,7 @@
 * themes: Improve CLI, add ``deactivate`` command.
 * themes: Proper template path fixup for the theme configuration.
 
-11.1 Core
+12.1 Core
 ----------------------
 
 * config: Make sure ``site/auto_formats`` has at least ``html`` .
@@ -770,7 +801,7 @@
 * templating: Make Jinja support arbitrary extension, show warning for old stuff.
 * templating: ``highlight_css`` can be passed the name of a Pygments style.
 
-11.2 Bugfixes
+12.2 Bugfixes
 ----------------------
 
 * bug: Fix a crash with the ``ordered`` page source when sorting pages.
@@ -778,7 +809,7 @@
 * bug: Forgot to add a new file like a big n00b.
 * bug: Of course I broke something. Some exceptions need to pass through Jinja.
 
-11.3 Project
+12.3 Project
 ----------------------
 
 * cm: Add ``unidecode`` to requirements.
@@ -803,7 +834,7 @@
 * tests: Help the Yaml loader figure out the encoding on Windows.
 * tests: Normalize test paths using the correct method.
 
-11.4 Miscellaneous
+12.4 Miscellaneous
 ----------------------
 
 * bake/serve: Improve support for unicode, add slugification options.
@@ -814,27 +845,27 @@
 * sass: Overwrite the old map file with the new one always.
 
 ==================================
-12. PieCrust 2.0.0a13 (2015-07-14)
+13. PieCrust 2.0.0a13 (2015-07-14)
 ==================================
 
 
-12.0 Commands
+13.0 Commands
 ----------------------
 
 * bake: Fix a bug with copying assets when ``pretty_urls`` are disabled.
 
-12.2 Bugfixes
+13.2 Bugfixes
 ----------------------
 
 * bug: Correctly setup the environment/app for bake workers.
 * bug: Fix copying of page assets during the bake.
 
 ==================================
-13. PieCrust 2.0.0a12 (2015-07-14)
+14. PieCrust 2.0.0a12 (2015-07-14)
 ==================================
 
 
-13.0 Commands
+14.0 Commands
 ----------------------
 
 * bake: Abort "render first" jobs if we start using other pages.
@@ -855,7 +886,7 @@
 * serve: Fix crash on start.
 * serve: Use Werkzeug's HTTP exceptions correctly.
 
-13.1 Core
+14.1 Core
 ----------------------
 
 * debug: Add support for more attributes for the debug info.
@@ -893,7 +924,7 @@
 * templating: Let Jinja2 cache the parsed template for page contents.
 * templating: Workaround for a bug with Pystache.
 
-13.2 Bugfixes
+14.2 Bugfixes
 ----------------------
 
 * bug: Fix CLI crash caused by configuration variants.
@@ -901,7 +932,7 @@
 * bug: Fix infinite loop in Jinja2 rendering.
 * bug: Fix routing bug introduced by 21e26ed867b6.
 
-13.3 Project
+14.3 Project
 ----------------------
 
 * cm: Add script to generate benchmark websites.
@@ -913,25 +944,25 @@
 * tests: Fix Jinja2 test.
 * tests: Fix crash in processing tests.
 
-13.4 Miscellaneous
+14.4 Miscellaneous
 ----------------------
 
 * Fixed 'bootom' to 'bottom'
 * markdown: Cache the formatter once.
 
 ==================================
-14. PieCrust 2.0.0a11 (2015-05-18)
+15. PieCrust 2.0.0a11 (2015-05-18)
 ==================================
 
 
-14.0 Commands
+15.0 Commands
 ----------------------
 
 * bake: Return all errors from a bake record entry when asked for it.
 * serve: Fix bug where ``?!debug`` doesn't get appending correctly.
 * serve: Remove development assert.
 
-14.1 Core
+15.1 Core
 ----------------------
 
 * data: Fix regression bug with accessing page metadata that doesn't exist.
@@ -939,7 +970,7 @@
 * linker: Fix linker returning the wrong value for ``is_dir`` in some situations.
 * pagination: Fix regression bug with previous/next posts.
 
-14.3 Project
+15.3 Project
 ----------------------
 
 * tests: Add support for testing the Chef server.
@@ -948,27 +979,27 @@
 * tests: More accurate marker position for diff'ing strings.
 * tests: Move all bakes/cli/servings tests files to have a YAML extension.
 
-14.4 Miscellaneous
+15.4 Miscellaneous
 ----------------------
 
 * jinja: Look for ``html`` extension first instead of last.
 
 ==================================
-15. PieCrust 2.0.0a10 (2015-05-15)
+16. PieCrust 2.0.0a10 (2015-05-15)
 ==================================
 
 
-15.3 Project
+16.3 Project
 ----------------------
 
 * setup: Add ``requirements.txt`` to ``MANIFEST.in`` so it can be used by the setup.
 
 ==================================
-16. PieCrust 2.0.0a9 (2015-05-11)
+17. PieCrust 2.0.0a9 (2015-05-11)
 ==================================
 
 
-16.0 Commands
+17.0 Commands
 ----------------------
 
 * serve: Add a WSGI utility module for easily getting a default app.
@@ -977,14 +1008,14 @@
 * serve: Compatibility with ``mod_wsgi`` .
 * serve: Split the server code in a couple modules inside a ``serving`` package.
 
-16.1 Core
+17.1 Core
 ----------------------
 
 * data: Fix problems with using non-existing metadata on a linked page.
 * internal: Make it possible to pass ``argv`` to the main Chef function.
 * routing: Fix bugs with matching URLs with correct route but missing metadata.
 
-16.3 Project
+17.3 Project
 ----------------------
 
 * docs: Add documentation for deploying as a dynamic CMS.
@@ -995,11 +1026,11 @@
 * tests: Fix serving unit-tests.
 
 ==================================
-17. PieCrust 2.0.0a8 (2015-05-03)
+18. PieCrust 2.0.0a8 (2015-05-03)
 ==================================
 
 
-17.0 Commands
+18.0 Commands
 ----------------------
 
 * bake: Fix crash when handling bake errors.
@@ -1009,7 +1040,7 @@
 * sources: Fix how the ``autoconfig`` source iterates over its structure.
 * theme: Fix link to PieCrust documentation.
 
-17.1 Core
+18.1 Core
 ----------------------
 
 * caching: Use separate caches for config variants and other contexts.
@@ -1017,23 +1048,23 @@
 * internal: Return the first route for a source if no metadata match is needed.
 * linker: Don't put linker stuff in the config.
 
-17.3 Project
+18.3 Project
 ----------------------
 
 * tests: Changes to output report and hack for comparing outputs.
 
-17.4 Miscellaneous
+18.4 Miscellaneous
 ----------------------
 
 * Update ``requirements.txt`` .
 * Update development ``requirements.txt`` , add code coverage tools.
 
 ==================================
-18. PieCrust 2.0.0a7 (2015-04-20)
+19. PieCrust 2.0.0a7 (2015-04-20)
 ==================================
 
 
-18.0 Commands
+19.0 Commands
 ----------------------
 
 * bake: Improve render context and bake record, fix incremental bake bugs.
@@ -1047,7 +1078,7 @@
 * serve: Fix crash on URI parsing.
 * showrecord: Add ability to filter on the output path.
 
-18.1 Core
+19.1 Core
 ----------------------
 
 * config: Add ``default_page_layout`` and ``default_post_layout`` settings.
@@ -1059,7 +1090,7 @@
 * internal: Use hashes for cache paths.
 * pagination: Make pagination use routes to generate proper URLs.
 
-18.3 Project
+19.3 Project
 ----------------------
 
 * build: Put dev-only lib requirements into a ``dev-requirements.txt`` file.
@@ -1074,17 +1105,17 @@
 * tests: Remove debug output.
 * tests: Support for YAML-based baking tests. Convert old code-based ones.
 
-18.4 Miscellaneous
+19.4 Miscellaneous
 ----------------------
 
 * cleancss: Fix stupid bug.
 
 ==================================
-19. PieCrust 2.0.0a6 (2015-03-30)
+20. PieCrust 2.0.0a6 (2015-03-30)
 ==================================
 
 
-19.0 Commands
+20.0 Commands
 ----------------------
 
 * bake: Better error handling for site baking.
@@ -1133,7 +1164,7 @@
 * theme: Updated "quickstart" text shown for new websites.
 * themes: Add the ``chef themes`` command
 
-19.1 Core
+20.1 Core
 ----------------------
 
 * config: Assign correct data endpoint for blogs to be v1-compatible.
@@ -1170,7 +1201,7 @@
 * render: When a template engine can't be found, show the correct name in the error.
 * routing: Better generate URLs according to the site configuration.
 
-19.3 Project
+20.3 Project
 ----------------------
 
 * build: Add ``pystache`` to ``requirements.txt`` .
@@ -1212,7 +1243,7 @@
 * tests: Patch ``os.path.exists`` and improve patching for ``open`` .
 * tests: Remove debug output.
 
-19.4 Miscellaneous
+20.4 Miscellaneous
 ----------------------
 
 * Add bower configuration file.
@@ -1247,11 +1278,11 @@
 * sitemap: Fixed typo bug.
 
 ==================================
-20. PieCrust 2.0.0a5 (2015-01-03)
+21. PieCrust 2.0.0a5 (2015-01-03)
 ==================================
 
 
-20.0 Commands
+21.0 Commands
 ----------------------
 
 * bake: Don't crash stupidly when there was no previous version.
@@ -1268,12 +1299,12 @@
 * sources: Add an ``IListableSource`` interface for sources that can be listed.
 * sources: Make the ``SimplePageSource`` more extensible, fix bugs in ``prose`` source.
 
-20.1 Core
+21.1 Core
 ----------------------
 
 * linker: Actually implement the ``Linker`` class, and use it in the page data.
 
-20.3 Project
+21.3 Project
 ----------------------
 
 * build: Add Travis-CI config file.
@@ -1281,7 +1312,7 @@
 * tests: Add unit tests for routing classes.
 * tests: Fix serving test.
 
-20.4 Miscellaneous
+21.4 Miscellaneous
 ----------------------
 
 * Ability to output debug logging to ``stdout`` when running unit-tests.