Merge pull request #60 from mdboom/minor-doc-improvements

Minor documentation improvements

schemas/stsci.edu/asdf/0.1.0/core/asdf.yaml

@@ -3,6 +3,7 @@
 $schema: "http://stsci.edu/schemas/yaml-schema/draft-01"
 id: "http://stsci.edu/schemas/asdf/0.1.0/core/asdf"
 title: |
+  Top-level schema for every ASDF file.
 
 description: |
   This schema contains the top-level attributes for every ASDF file.

source/conf.py

@@ -28,7 +28,8 @@
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
 mathjax_path="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"
-extensions = ['sphinx.ext.mathjax', 'sphinx.ext.ifconfig', 'sphinxext.category']
+extensions = ['sphinx.ext.mathjax', 'sphinx.ext.ifconfig',
+              'sphinx.ext.graphviz', 'sphinxext.category']
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
@@ -229,7 +230,7 @@
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title, author, documentclass [howto/manual]).
 latex_documents = [
-  ('index', 'ASDFStandard-{0}.tex'.format(version), u'ASDF Standard v{0}'.format(version),
+  ('index', 'ASDFStandard-{0}.tex'.format(version), u'ASDF Standard',
    u'Michael Droettboom, Erik Bray, et al\\\\Space Telescope Science Institute',
    'manual'),
 ]

source/schemas/index.rst

@@ -17,3 +17,13 @@ must support the "core" module, but the other modules are optional.
    unit.rst
    transform.rst
    wcs.rst
+
+The following graph shows the dependencies between modules:
+
+.. digraph:: modules
+
+   "fits" -> "core"
+   "unit" -> "core"
+   "transform" -> "core"
+   "wcs" -> "transform"
+   "wcs" -> "unit"