I think I combined two things in my first version which should be separated: linking to the ticket and linking to documentation. I agree with you that the documentation should be optional. I think the project management ticket should be linked if the author remembers (if the author forgets, no big deal, but creates a nice documentation chain if it can become a team habit).

Tried simplifying in 84f6956. Better?