I just noticed that Vance Morrison posted the source code to his latest project (Hyperaddin for Visual Studio) on CodePlex.
I have long thought that source code comments were not enough to explain what is really going on... often you need to refer the read to other methods or areas of the code. Well, luckily for me, Vance and gang saw the same problem and went out to solve it.
Here are a few simple examples:
// In this comment I wanted to talk about the code:MethodTable::Unbox method.
// By Adding a code: hyperlink, readers can quickly navigate to it. Any name
// that can be found using the Edit.FindSymbol (Alt-F12) can be used. If you
// need to refer to an overloaded method, it is best to use an anchor (see below).
// Somewhere else in the file you can refer to code:#mytopic. Now readers
// can quickly navigate to the #mytopic anchor.
// I need to refer to #mytopic but it is not in the current file. But I
// know that this anchor is related to the class 'MethodTable' and thus will
// be in the same file as that class definition by using code:MethodTable#mytopic
// I can refer to #mytopic anywhere in any code within the solution.
Check it out: