Literary norms for code comments

The role of the comments is to convey the context for a piece of code. That is mainly the "why", the goal and the mission for that code. Some key implementation details are also helpful, assuming they are not obvious from the code itself. It is definitely benefitial to put links to related specs and code, preferably permalinks. A very normal thing is to reference the ticket that introduced the change.