add contributing.rst to index.rst

Author: jreback

docs/source/contributing.rst

@@ -37,21 +37,21 @@ Bug reports must:
 
 #. Include a short, self-contained Python snippet reproducing the problem.
    You can format the code nicely by using `GitHub Flavored Markdown
-   <http://github.github.com/github-flavored-markdown/>`_::
+   <http://github.github.com/github-flavored-markdown/>`__
+
+   .. code-block:: python
 
-      ```python
       >>> from pandas_gbq import gbq
       >>> df = gbq.read_gbq(...)
       ...
-      ```
 
-#. Include the full version string of *pandas-gbq*. ::
+#. Include the full version string of *pandas-gbq*.
+
+   .. code-block:: python
 
-      ```python
       >>> import pandas_gbq
       >>> pandas_gbq.__version__
       ...
-      ```
 
 #. Explain why the current behavior is wrong/not desired and what you expect instead.
 
@@ -282,7 +282,7 @@ directive. This should also be put in the docstring when adding a new function
 or method.
 
 Contributing your changes to *pandas-gbq*
-=====================================
+=========================================
 
 Committing your code
 --------------------
@@ -438,4 +438,4 @@ branch has not actually been merged.
 
 The branch will still exist on GitHub, so to delete it there do::
 
-    git push origin --delete shiny-new-feature
+    git push origin --delete shiny-new-feature

docs/source/index.rst

@@ -30,6 +30,7 @@ Contents:
    writing.rst
    tables.rst
    api.rst
+   contributing.rst
    changelog.rst
 
 

docs/source/reading.rst

@@ -1,7 +1,7 @@
 .. _reader:
 
-Reading
-=======
+Reading Tables
+==============
 
 Suppose you want to load all data from an existing BigQuery table : `test_dataset.test_table`
 into a DataFrame using the :func:`~read_gbq` function.

docs/source/tables.rst

@@ -1,7 +1,7 @@
 .. _create_tables:
 
-Creating BigQuery Tables
-========================
+Creating Tables
+===============
 
 .. code-block:: ipython