More doc cleanup

Author: mwcraig

docs/api.rst

@@ -1,7 +1,7 @@
 .. _api_reference:
 
-AID API Reference
-=================
+AID API
+=======
 
 .. automodapi:: astro_image_display_api.interface_definition
     :no-inheritance-diagram:

docs/index.rst

@@ -28,7 +28,7 @@ How to implement this API in your package
    step explains how to assert that your package implements the API correctly.
 2. :ref:`testing_AIDA_implementation` describes how to test your
    package against the API.
-3. There is a :ref:`reference_implementation` of the API that you can use as a
+3. There is a :ref:`sample implementation <reference_implementation>` of the API that you can use as a
    starting point for your own package. This reference implementation does not
    do any image display itself, but provides a set of methods that you can
    override to implement your own image display logic on top of the management
@@ -41,6 +41,6 @@ How to implement this API in your package
   :hidden:
 
   api.rst
-  reference_implementation.rst
   testing_implementation.rst
+  reference_implementation.rst
   aida_backends.rst

docs/reference_implementation.rst

@@ -1,7 +1,7 @@
 .. _reference_implementation:
 
-Reference implementation of AIDA non-display logic
-==================================================
+Sample implementation
+=====================
 
 The class `astro_image_display_api.image_viewer_logic.ImageViewerLogic` is provided
 as an *example* of how to implement the non-display logic of the Astronomical Image Display API (AIDA).

docs/testing_implementation.rst

@@ -1,7 +1,7 @@
 .. _testing_AIDA_implementation:
 
-Testing your implementation of AIDA
-===================================
+Testing
+=======
 
 Our goal is to make it easy for you to test your implementation of the
 Astronomical Image Display API (AIDA). There are two things you need to test: