[dorwi]

Oh no, never link to tickets or docs that are not version controled in the same repo. Usually code tends to outlive the tools for organisation.

[usr1106]

So should we live in darkness now because the link might break 3, 5 or 10 years later?

It's also a misguided tools upgrade if they have no way to redirect, convert or otherwise handle old links.

[pc86]

Link to things in the same repo, like a wiki or external document (if you're linking to external stuff anyway). You have to assume whatever you link to will disappear without notification. At least if it's in the repo, you can check out the old commit and get the file back, and hopefully find the commit where it was removed and see why it was removed.

If you link to Sharepoint or something it's useless as soon as that link changes.

[LordDragonfang]

In my experience, then, most tools upgrades are misguided.

[worik]

No we should live in light!

But make the boss understand...

[furstenheim]

But even if the link eventually dies, you have the business explanation.

Normally the comment is an explanation of the intent but the referenced ticket has the full discussion and backing data that led to the decision