I changed the way I create links to use references to a data YML file instead of relying on the capture tag and including reference to the file with the captions. Using the capture tag was highly susceptible to broken links and way too manual. See the Links topic for more detail about the new method.

index.md

@@ -4,7 +4,40 @@ tags: [getting-started]
 type: first_page
 homepage: true
 ---
-{% if site.project == "doc_designers" %}
-{% include custom/doc/doc_homepage.md %}
-{% endif %}
+## Overview 
+
+This site provides documentation, training, and other notes for the Jekyll Documentation theme. There's a lot of information about how to do a variety of things here, and it's not all unique to this theme. But by and large, understanding how to do things in Jekyll depends on how your theme is coded. 
+
+## Survey of features
+
+Some of the more prominent features of this theme include the following:
+
+* Bootstrap framework
+* Sidebar with page hierarchy and advanced toc
+* PDF generation (with Prince XML utility)
+* Notes, tips, and warning information notes
+* Tags
+* Single sourced outputs
+* Emphasis on pages, not posts
+* Relative (rather than absolute) link structure
+
+I'm using this theme for my documentation projects, building about 15 different outputs for various products, versions, languages, and audiences from the same set of files. This single sourcing requirement has influenced how I constructed this theme.
+
+For more discussion about the available features, see {{site.data.urls_d.doc_supported_features.link}}.
+
+## Getting started
+
+To get started, see these three topics:
+
+1. {{site.data.urls.doc_getting_started.link}}
+2. {{site.data.urls.doc_configuration_settings.link}}
+3. {{site.data.urls.doc_customizing_the_theme.link}}
+
+## PDF Download 
+
+If you would like to download this help file as a PDF, you can do so here. The PDF most of the same content as the online help, except that some elements (such as video or special layouts) don't translate the the print medium, so they're excluded.
+
+<a target="_blank" class="noCrossRef" href="doc_{{site.audience}}_pdf.pdf"><button type="button" class="btn btn-default" aria-label="Left Align"><span class="glyphicon glyphicon-download-alt" aria-hidden="true"></span> PDF Download</button></a>
+
+The PDF contains a timestamp in the header indicating when it was last generated. If you download a PDF, keep in mind that it may go out of date quickly. Always compare your PDF timestamp against the online help timestamp (which you can find in the footer).