added some docs and one test (my first test ever!).

Author: vilhelmp

astroquery/nasa_ads/tests/test_nasaads.py

@@ -0,0 +1,5 @@
+from ... import nasa_ads
+
+def test_simple(patch_post):
+    x = nasa_ads.ADS.query_simple('^Persson Origin of water around deeply embedded low-mass protostars')
+    assert x[-1]['authors'][0] == 'Persson, M. V.'

docs/nasa_ads/nasa_ads.rst

@@ -10,26 +10,42 @@ Getting Started
 ===============
 
 This module provides an interface to the online `SAO/NASA Astrophysics Data System`_.
+At the moment only the "simple search", i.e. omni-box search is available, and only 
+a subset of the results are accessible.
 
 Examples
 ========
 
-
 Search works by specific identifier
 -----------------------------------
 
+from astroquery import nasa_ads as na
+# the "^" makes ADS to return only papers where Persson 
+# is first author
+results = na.ADS.query_simple('^Persson Origin of water\
+	 around deeply embedded low-mass protostars') results[0].title 
+
+# to sort after publication date
+results.sort(['pubdate']) 
+
+# get the title of the last hit
+title = results[-1]['title'][0] 
+
+# printout the authors of the last hit
+print results[-1]['authors']
+
 
 Get links 
 ---------
-
+Not yet implemented.
 
 Download publisher/ArXiv PDF
 ----------------------------
-
+Not yet implemented.
 
 Get Bibtex
 ----------
-
+Not yet implemented.