further docs improvements

README.rst

@@ -7,20 +7,24 @@ Observation planning package for astronomers
 * Docs: https://astroplan.readthedocs.io/
 * License: BSD-3
 
-.. image:: http://img.shields.io/badge/powered%20by-AstroPy-orange.svg?style=flat
-    :target: http://www.astropy.org/
+.. image:: https://readthedocs.org/projects/astroplan/badge/?version=latest
+    :target: https://astroplan.readthedocs.io/en/latest/?badge=latest
+    :alt: Documentation Status
 
-.. image:: http://img.shields.io/pypi/v/astroplan.svg?text=version
-    :target: https://pypi.python.org/pypi/astroplan/
-    :alt: Latest release
-
 .. image:: http://img.shields.io/badge/arXiv-1709.03913-red.svg?style=flat
     :target: https://arxiv.org/abs/1712.09631
     :alt: arXiv paper
 
 .. image:: https://github.com/astropy/astroplan/workflows/CI%20Tests/badge.svg
     :target: https://github.com/astropy/astroplan/actions
 
+.. image:: http://img.shields.io/badge/powered%20by-AstroPy-orange.svg?style=flat
+    :target: http://www.astropy.org/
+
+.. image:: http://img.shields.io/pypi/v/astroplan.svg?text=version
+    :target: https://pypi.python.org/pypi/astroplan/
+    :alt: Latest release
+
 Attribution
 +++++++++++
 

docs/index.rst

@@ -53,13 +53,28 @@ Maintainers
 -----------
 * `Brett Morris, including contributions from Google Summer of Code 2015 <https://www.google-melange.com/gsoc/project/details/google/gsoc2015/bmmorris/5707702298738688>`_
 
-Contributors
-------------
-* `Jazmin Berlanga Medina, including contributions from Google Summer of Code 2015 <https://www.google-melange.com/gsoc/project/details/google/gsoc2015/jberlanga/5707702298738688>`_
-* Christoph Deil
-* Stephanie Douglas
-* Eric Jeschke
-* Adrian Price-Whelan
-* Erik Tollerud
-* Brigitta Sipocz
-* Karl Vyhmeister
+Attribution
++++++++++++
+
+If you use astroplan in your work, please cite `Morris et al. 2018 <https://ui.adsabs.harvard.edu/abs/2018AJ....155..128M/abstract>`_:
+
+.. code :: bibtex
+
+  @ARTICLE{2018AJ....155..128M,
+         author = {{Morris}, Brett M. and {Tollerud}, Erik and {Sip{\H{o}}cz}, Brigitta and {Deil}, Christoph and {Douglas}, Stephanie T. and {Berlanga Medina}, Jazmin and {Vyhmeister}, Karl and {Smith}, Toby R. and {Littlefair}, Stuart and {Price-Whelan}, Adrian M. and {Gee}, Wilfred T. and {Jeschke}, Eric},
+          title = "{astroplan: An Open Source Observation Planning Package in Python}",
+        journal = {\aj},
+       keywords = {methods: numerical, methods: observational, Astrophysics - Instrumentation and Methods for Astrophysics},
+           year = 2018,
+          month = mar,
+         volume = {155},
+         number = {3},
+            eid = {128},
+          pages = {128},
+            doi = {10.3847/1538-3881/aaa47e},
+  archivePrefix = {arXiv},
+         eprint = {1712.09631},
+   primaryClass = {astro-ph.IM},
+         adsurl = {https://ui.adsabs.harvard.edu/abs/2018AJ....155..128M},
+        adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+  }