When writing DOCUMENTS, i'd prefer links be references in the bottom of the doc with intelligent re-usable id's.  If you're referring to a URL more than once, it uses less space and is easier to change the reference ID than multiple links.

this would become

```
[Semantic Versioning][semver]
```
and at the bottom of the file
```
[semver]: http://semver.org/ "Optional title attribute goes here"
```