Update docs

docs/conf.py

@@ -12,9 +12,9 @@
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #
-# import os
-# import sys
-# sys.path.insert(0, os.path.abspath('.'))
+import os
+import sys
+sys.path.insert(0, os.path.abspath('..'))
 
 
 # -- Project information -----------------------------------------------------
@@ -76,7 +76,7 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = 'flask'
+html_theme = 'alabaster'
 
 html_context = {
     "css_files": ["_static/index.css"]
@@ -87,7 +87,9 @@
 # documentation.
 #
 html_theme_options = {
-    "github_fork": "j0ack/pybeeryaml",
+    'github_user': 'j0ack',
+    'github_repo': 'pybeeryaml',
+    'github_banner': True
 }
 
 # Add any paths that contain custom static files (such as style sheets) here,

docs/index.rst

@@ -3,15 +3,20 @@ PyBeerYAML
 
 |pyversion| |version| |license| |travis|
 
-A YAML format parser for beer storage.
+A Python YAML format parser for beer storage.
 
-Parse a recipe from a YAML file and returns an object containing ingredients and
-metadata. Supports export to `beerxml <http://beerxml.com/>`_ format.
+Parse a recipe from a `beeryaml <http://beeryaml.rtfd.io/>`_ file and returns
+an object containing ingredients and metadata. Supports export to
+`beerxml <http://beerxml.io/>`_ format.
+
+For more information about the beeryaml format please read the following
+documentation:
+
+http://beeryaml.rtfd.io/
 
 .. toctree::
    :maxdepth: 1
 
-   yaml_format
    quickstart
    contribute
    api/pybeeryaml