Juliano F. Ravasi wrote:
Brion Vibber wrote:
If you do point to external documentation instead of keeping the details in one place, put in a URL if possible to make it easy to jump right there.
From my personal experience, avoid putting URLs in commit messages. Commit messages are more or less set in stone after the commit, to change them you have to go through a few hiccups on most VCSs; while URLs are very dynamic, may change or became unavailable easily.
Are you suggesting easy changing of URLs?? You shall be condemned to sort the web for the rest of your days!! http://www.w3.org/Provider/Style/URI