Update docs for v0.1.1

Author: shoyer

README.md

@@ -152,18 +152,15 @@ labeled numpy arrays that provided some guidance for the design of xray.
 For more details, see the **[full documentation][docs]**, particularly the
 **[tutorial][tutorial]**.
 
-xray requires Python 2.7 and recent versions of [numpy][numpy] (1.8.0 or
-later) and [pandas][pandas] (0.13.1 or later). [netCDF4-python][nc4],
+xray requires Python 2.7 or 3.3 and recent versions of [numpy][numpy] (1.7.0
+or later) and [pandas][pandas] (0.13.1 or later). [netCDF4-python][nc4],
 [pydap][pydap] and [scipy][scipy] are optional: they add support for reading
 and writing netCDF files and/or accessing OpenDAP datasets.
 
 You can install xray from the pypi with pip:
 
     pip install xray
 
-Python 3 is supported on the current development version (available from
-Github).
-
 [docs]: http://xray.readthedocs.org/
 [tutorial]: http://xray.readthedocs.org/en/latest/tutorial.html
 [numpy]: http://www.numpy.org/
@@ -190,9 +187,13 @@ xray:
    to support `Dataset` objects linked to NetCDF or HDF5 files on disk to
    allow for incremental writing of data.
 
+If you have questions or comments about any of this, please feel free to raise
+a GitHub issue or get in touch via the [mailing list][mailing list].
+
 [blaze]: https://github.com/ContinuumIO/blaze/
 [blz]: https://github.com/ContinuumIO/blz
 [biggus]: https://github.com/SciTools/biggus
+[mailing list]: https://groups.google.com/forum/#!forum/xray-discussion
 
 ## About xray
 

doc/conf.py

@@ -87,11 +87,14 @@ def __getattr__(cls, name):
     'sphinx.ext.autodoc',
     'sphinx.ext.autosummary',
     'sphinx.ext.intersphinx',
+    'sphinx.ext.extlinks',
     'numpydoc',
     'IPython.sphinxext.ipython_directive',
     'IPython.sphinxext.ipython_console_highlighting',
 ]
 
+extlinks = {'issue': ('https://github.com/xray/xray/issues/%s', 'GH')}
+
 autosummary_generate = True
 
 numpydoc_class_members_toctree = True

doc/index.rst

@@ -45,17 +45,17 @@ compatibility with the full `PyData ecosystem <http://pydata.org/>`__.
 For a longer introduction to **xray** and its design goals, see
 `the project's GitHub page <http://github.com/xray/xray>`__. The GitHub
 page is where to go to look at the code, report a bug or make your own
-contribution. You can also get in touch via `Twitter
-<http://twitter.com/shoyer>`__.
+contribution. If you have questions or more general feedback about xray, feel
+free to get in touch via `Twitter <http://twitter.com/shoyer>`__  or the
+`mailing list <https://groups.google.com/forum/#!forum/xray-discussion>`__.
 
 .. note ::
 
-    **xray** is still very new -- it is on its first release and is only a few
-    months old. Although we will make a best effort to maintain the current
-    API, it is likely that the API will change in future versions as xray
-    matures. Some changes are already anticipated, as called out in the
-    `Tutorial <tutorial>`_ and the project `README
-    <http://github.com/xray/xray>`__.
+    **xray** is still very new -- it is only a few months old. Although we will
+    make a best effort to maintain the current API, it is likely that the API
+    will change in future versions as xray matures. Some changes are already
+    anticipated, as called out in the `Tutorial <tutorial>`_ and the project
+    `README <http://github.com/xray/xray>`__.
 
 Contents
 --------
@@ -67,3 +67,4 @@ Contents
    tutorial
    data-structures
    api
+   whats_new

doc/installing.rst

@@ -1,8 +1,9 @@
 Installing xray
 ===============
 
-xray requires Python 2.7 and recent versions of
-`numpy <http://www.numpy.org/>`__ (1.8.0 or later) and
+xray runs on Python 2.7 and Python 3.3 (Python 3.4 has not yet been tested).
+It also requires
+`numpy <http://www.numpy.org/>`__ (1.7 or later) and
 `pandas <http://pandas.pydata.org/>`__ (0.13.1 or later).
 `netCDF4-python <https://github.com/Unidata/netcdf4-python>`__,
 `pydap <http://www.pydap.org/>`__ and `scipy <http://scipy.org/>`__ are

doc/whats_new.rst

@@ -0,0 +1,22 @@
+What's New
+==========
+
+v0.1.1 (20 May 2014)
+--------------------
+
+xray 0.1.1 is a bug-fix release that includes changes that should be almost
+entirely backwards compatible with v0.1:
+
+- Python 3 support (:issue:`53`)
+- Required numpy version relaxed to 1.7 (:issue:`129`)
+- Return numpy.datetime64 arrays for non-standard calendars (:issue:`126`)
+- Support for opening datasets associated with NetCDF4 groups (:issue:`127`)
+- Bug-fixes for concatenating datetime arrays (:issue:`134`)
+
+Special thanks to new contributors Thomas Kluyver, Joe Hamman and Alistair
+Miles.
+
+v0.1 (2 May 2014)
+-----------------
+
+Initial release.

setup.py

@@ -9,8 +9,8 @@
     from distutils.core import setup
 
 MAJOR = 0
-MINOR = 2
-MICRO = 0
+MINOR = 1
+MICRO = 1
 ISRELEASED = False
 VERSION = '%d.%d.%d' % (MAJOR, MINOR, MICRO)
 QUALIFIER = ''
@@ -19,14 +19,15 @@
 DISTNAME = 'xray'
 LICENSE = 'Apache'
 AUTHOR = 'Stephan Hoyer, Alex Kleeman, Eugene Brevdo'
-AUTHOR_EMAIL = 'shoyer@climate.com'
+AUTHOR_EMAIL = 'xray-discussion@googlegroups.com'
 URL = 'https://github.com/xray/xray'
 CLASSIFIERS = [
     'Development Status :: 3 - Alpha',
     'License :: OSI Approved :: Apache Software License',
     'Operating System :: OS Independent',
     'Intended Audience :: Science/Research',
     'Programming Language :: Python :: 2.7',
+    'Programming Language :: Python :: 3.3',
     'Topic :: Scientific/Engineering',
 ]