Fix some redirection links in documentation

[dufferzafar]

This fixes #606.

I wrote this python script to fix the docs. It uses the linkcheck output to work.

Most of the links have been fixed but in the docs/news.rst file all github issues are referred using issue_role, even pull requests.

Like this line refers to issue 693. But 693 is actually a pull request!

Should I create a new role for pulls (in docs/_ext/scrapydocs.py) to fix them as well?

[kmike]

Looks good, +1 to merge.
I'm fine with explicit /2/ links to python docs and /en/latest links to RTFD.

[eliasdorneles]

I don't understand why this build fails, it doesn't even touch the code.
Anyway, LGTM.

[kmike]

@eliasdorneles it failed because of #1034

[curita]

LGTM too, but I'd also add the script because we'll surely need it again. @dufferzafar can you add the linkfix.py script to the repo? I think we could create a folder under docs (let's say docs/utils) and put it there.

[dufferzafar]

@curita Will do that today. If there's anything else you need from the script, please let me know.

[pablohoffman]

what about adding a sub-command to documentation Makefile (docs/Makefile)?. There's already a linkcheck (using standard sphinx plugin: http://sphinx-doc.org/latest/_modules/sphinx/builders/linkcheck.html)

[curita]

@pablohoffman: @dufferzafar's script uses linkcheck output to fix those links. Maybe we could add a command in the Makefile that runs linkcheck and then runs this script?

Could be something like:

linkfix: linkcheck
    $(PYTHON) utils/linkfix.py
    @echo "Fixing redirecting links in docs has finished, check all replacements before committing them"

[pablohoffman]

@curita that sounds good, can you add and merge?

[curita]

Merged in e17f97e