Afaik the ~ is being used to link to classes in pandas. Not sure why, will check.

~ hides the class name. We'll occasionally use it when referring to a method on either Series or DataFrame, instead of doing

:meth:`Series.head` or :meth:`DataFrame.head`

Found it! http://www.sphinx-doc.org/en/stable/domains.html#cross-referencing-syntax

I will modify the PR to say this.

Thanks a lot, very useful.

BTW, @dukebody also welcome to do this change in the version in the pandas docs as well

Now that is merged, we should maybe use that one to keep up to date and link to? To not duplicate the changes each time?

@jorisvandenbossche done: pandas-dev/pandas#20402

Now that is merged, we should maybe use that one to keep up to date and link to? To not duplicate the changes each time?

I agree. Should we delete the guide contents from this repo and replace every page with a link to the development version of the docs, like http://pandas-docs.github.io/pandas-docs-travis/contributing.html.