md to rst

[bscheshir]

actual instructions in rst

fixed #3689

[devyte]

@igrr this fixes the links to the docs. Do we want that, or do we want to migrate the docs to markdown, or do we want both?

[igrr]

@devyte Well the docs have been migrated from .md to .rst recently to be able to use readthedocs, so we just want to fix the remaining broken links.

@bscheshir Thank you for the fix. Do you think that pointing to HTML docs will be nicer/more useful? E.g. http://arduino-esp8266.readthedocs.io/en/latest/Troubleshooting/debugging.html.
If yes, would you mind amending your commit?

[bscheshir]

@igrr http://arduino-esp8266.readthedocs.io/en/latest/Troubleshooting/debugging.html is automatic build from latest (last release) tag? I am right?

but old link
https://github.com/esp8266/Arduino/blob/master/doc/Troubleshooting/debugging.md and new link
https://github.com/esp8266/Arduino/blob/master/doc/Troubleshooting/debugging.rst is master branch, not is a latest tag

[igrr]

"latest" on readthedocs is automatically built from master on each commit. To get docs for tagged version (e.g. v2.4.0-rc1), replace "latest" with the tag name.

[bscheshir]

So... I think is arduino-esp8266.readthedocs.io have a good design, but https://github.com/esp8266/Arduino is a same host with repo, I think more people trust github.

I vote for github 😺