Small documentation fixes (#1516)

* Clarify in docs that inferring DataArray dimensions is deprecated

* Fix DataArray docstring

* Clarify DataArray coords documentation

Author: leezu

doc/data-structures.rst

@@ -46,9 +46,11 @@ The :py:class:`~xarray.DataArray` constructor takes:
 
 - ``data``: a multi-dimensional array of values (e.g., a numpy ndarray,
   :py:class:`~pandas.Series`, :py:class:`~pandas.DataFrame` or :py:class:`~pandas.Panel`)
-- ``coords``: a list or dictionary of coordinates
-- ``dims``: a list of dimension names. If omitted, dimension names are
-  taken from ``coords`` if possible.
+- ``coords``: a list or dictionary of coordinates. If a list, it should be a
+  list of tuples where the first element is the dimension name and the second
+  element is the corresponding coordinate array_like object.
+- ``dims``: a list of dimension names. If omitted and ``coords`` is a list of
+  tuples, dimension names are taken from ``coords``.
 - ``attrs``: a dictionary of attributes to add to the instance
 - ``name``: a string that names the instance
 

xarray/core/dataarray.py

@@ -175,9 +175,11 @@ def __init__(self, data, coords=None, dims=None, name=None,
         coords : sequence or dict of array_like objects, optional
             Coordinates (tick labels) to use for indexing along each dimension.
             If dict-like, should be a mapping from dimension names to the
-            corresponding coordinates.
+            corresponding coordinates. If sequence-like, should be a sequence
+            of tuples where the first element is the dimension name and the
+            second element is the corresponding coordinate array_like object.
         dims : str or sequence of str, optional
-            Name(s) of the the data dimension(s). Must be either a string (only
+            Name(s) of the data dimension(s). Must be either a string (only
             for 1D data) or a sequence of strings with length equal to the
             number of dimensions. If this argument is omitted, dimension names
             are taken from ``coords`` (if possible) and otherwise default to