Change `swap_dims` to rename_dims?

[tomchor]

Basically I'm trying to swap the names and data (basically the underlying numpy array would be the same, but the coords would change) of two dimensions in my DataArray and I was looking for options that could do that.

So I thought swap_dims would be a good candidate for that given its description but it doesn't work. In fact, based on the docs, I have no idea how to use it and what it does. Based off of issues like this it seems I'm not alone.

Maybe it would be good to add example of usage of this function?

[shoyer]

swap_dims would probably be better called rename_dims. It replaces one dimension with another on all variables in a Dataset.