move contents.rst into index.rst and update refs

Author: kip-hart

docs/source/conf.py

@@ -208,7 +208,7 @@
 # (source start file, target name, title,
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
-    ('contents', 'AABBTree.tex', 'AABBTree Documentation',
+    ('index', 'AABBTree.tex', 'AABBTree Documentation',
      'Kenneth Hart', 'howto'),
 ]
 
@@ -218,7 +218,7 @@
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
 man_pages = [
-    ('contents', 'AABBTree', 'AABBTree Documentation',
+    ('index', 'AABBTree', 'AABBTree Documentation',
      [author], 1)
 ]
 
@@ -229,7 +229,7 @@
 # (source start file, target name, title, author,
 #  dir menu entry, description, category)
 texinfo_documents = [
-    ('contents', 'AABBTree', 'AABBTree Documentation',
+    ('index', 'AABBTree', 'AABBTree Documentation',
      author, 'AABBTree',
      'Pure Python implementation of d-dimensional AABB tree.',
      'Miscellaneous'),

docs/source/contents.rst

@@ -1,5 +1,34 @@
-=================
-Introduction
-=================
+.. AABBTree documentation master file.
 
-Hello World!
+.. include:: ../../README.rst
+    :end-before: .. begin-badges
+
+.. Introduction
+.. include:: ../../README.rst
+    :start-after: .. begin-introduction
+    :end-before: .. end-introduction
+
+.. Image of AABB Tree
+.. figure:: _static/diagram.png
+  :alt: AABB Tree
+  :align: center
+
+  Left: An AABB tree, leaves numbered by insertion order.
+  Right: The AABBs and their bounding boxes.
+
+
+.. Installation and example sections
+.. include:: ../../README.rst
+  :start-after: .. begin-installation
+  :end-before: .. begin-documentation
+
+.. API
+.. include:: aabbtree.rst
+
+.. Contributing and license
+.. include:: ../../README.rst
+  :start-after: .. end-documentation
+
+.. admonition:: License
+
+  .. include:: ../../LICENSE.rst