Make links of hyperlinks (documentation)

[mjago]

Make documentation links `clickable'

[mjago]

@makenowjust Huh? So presumably these links shouldn't be hyperlinks ? I would assume some amount of consistency is preferable.

[makenowjust]

@mjago Ah, yes. I wanted you to write description for explanation. And we may want to improve Markdown processor for such a style link.

In fact, I prefer <http://...> style link to [...](http://...) in this case because [...] content says little. I think the URL and the context describe themselves fully.

[mjago]

@makenowjust Ok sorry - added a description. My only issue was when I tried to follow the link I had to copy-and-paste. I assumed it was an oversight so I made the `tiny change' to the markup to be consistent with other linked references. I have no opinion on the link descriptions.

[makenowjust]

@mjago But this pull request improve document quality. Good job!

[makenowjust]

@mjago I think you missed fixing links in src/debug/mach_o.cr.

[mjago]

@makenowjust Thanks - now formatted also.

[ysbaddaden]

The markdown processor should be enhanced to support autolinks instead. See http://spec.commonmark.org/0.27/#autolink