We imagined people would copy and paste blocks of code that we provide and none of that would include the actual URL in the text, only the link.

But you make a good point. And there's no reason not to do it (your solution is better in every case). We'll get on it. Thanks.