doc(): testing new docs, Round 5

Author: Devyn Stott

README.md

@@ -1,6 +1,8 @@
 # python-starter
 A starting spot for python projects. Embracing open source elements.
 
+![Documentation status](https://readthedocs.org/projects/python-starter/badge/?version=latest)
+
 # Project Structure
 
 This project follows the structure suggested in [Jan-Philip Gehrcke's Blog](https://gehrcke.de/2014/02/distributing-a-python-command-line-application/).

mkdocs.yml

@@ -1,7 +1,9 @@
 site_name: Python-Starter
 repo_url: https://github.com/SyntaxRules/python-starter/
+theme: readthedocs
+docs_dir: 'starter'
 pages:
-    - 'Home': 'overview.md'
+    - 'Overview': 'README.md'
     - 'User Guide':
-        - 'Quick Start': 'article1.md'
-        - 'Service API': 'article2.md'
+        - 'Quick Start': 'docs/user_guide/article1.md'
+        - 'Service API': 'docs/user_guide/article2.md'

docs/overview.md renamed to starter/README.md

@@ -1,3 +1,5 @@
 # Overview
 
 This is the project overview
+
+Wit foo bar

docs/README.md renamed to starter/docs/README.md

@@ -1,6 +1,19 @@
-# Welcome to MkDocs
+# Documentation
+
+The documentation uses [mkdocs.org](http://mkdocs.org) to build and serve itself. This produces pretty HTML pages for external viewing and is compatible with ReadtheDocs.org.
+
+To generate a PDF of this documentation use: https://github.com/jgrassler/mkdocs-pandoc
+
+## Generating a PDF
+
+To generate a PDF from mkdocs use [mkdocs-pandoc](https://github.com/jgrassler/mkdocs-pandoc).
+
+To install it, perform the following steps:
+
+1. yum install fonts-lmodern lmodern pandoc texlive-base texlive-latex-extra texlive-fonts-recommended texlive-latex-recommended texlive-xetex
+2. yum install texlive-latex texlive-pdfpages texlive-pdftex
+
 
-For full documentation visit [mkdocs.org](http://mkdocs.org).
 
 ## Commands