id,node_id,number,title,user,state,locked,assignee,milestone,comments,created_at,updated_at,closed_at,author_association,active_lock_reason,draft,pull_request,body,reactions,performed_via_github_app,state_reason,repo,type
530448473,MDU6SXNzdWU1MzA0NDg0NzM=,3583,DataArray.transpose cannot handle Ellipsis,22542812,closed,0,,,7,2019-11-29T17:51:51Z,2019-12-02T17:13:10Z,2019-12-01T06:17:30Z,NONE,,,,"While the documentation about [reshaping](http://xarray.pydata.org/en/stable/reshaping.html#reordering-dimensions) indicates that an Ellipsis can be used for `DataArray.transpose`, this is actually not the case:

```python
    def transpose(self, *dims: Hashable, transpose_coords: bool = None) -> ""DataArray"":
        if dims:
            if set(dims) ^ set(self.dims):
                raise ValueError(
                    ""arguments to transpose (%s) must be ""
                    ""permuted array dimensions (%s)"" % (dims, tuple(self.dims))
                )
```

On a site note, as long as `transpose_coords` defaults to `None`, it should be at least stated in the doc string that its current default is equal to `False`.


#### Output of ``xr.show_versions()``
<details>

INSTALLED VERSIONS
------------------
commit: None
python: 3.7.3 (default, Mar 27 2019, 22:11:17)
[GCC 7.3.0]
python-bits: 64
OS: Linux
OS-release: 3.16.0-10-amd64
machine: x86_64
processor:
byteorder: little
LC_ALL:
LANG: en_US.UTF-8
LOCALE: en_US.UTF-8
libhdf5: 1.10.4
libnetcdf: None

xarray: 0.14.0
pandas: 0.25.0
numpy: 1.16.4
scipy: 1.3.0
netCDF4: None
pydap: None
h5netcdf: 0.7.4
h5py: 2.9.0
Nio: None
zarr: None
cftime: None
nc_time_axis: None
PseudoNetCDF: None
rasterio: None
cfgrib: None
iris: None
bottleneck: None
dask: 2.3.0
distributed: 2.3.0
matplotlib: 3.0.3
cartopy: None
seaborn: None
numbagg: None
setuptools: 41.0.1
pip: 19.1.1
conda: 4.7.11
pytest: 5.0.1
IPython: 7.5.0
sphinx: 2.2.1

</details>
","{""url"": ""https://api.github.com/repos/pydata/xarray/issues/3583/reactions"", ""total_count"": 0, ""+1"": 0, ""-1"": 0, ""laugh"": 0, ""hooray"": 0, ""confused"": 0, ""heart"": 0, ""rocket"": 0, ""eyes"": 0}",,completed,13221727,issue