HTML sections aren't handled fully properly

[joshua-light]

When we process a reference to a method (like in <see> tag), we use HTML sections in order to construct a reference to the specific method. However, sometimes there are two methods with the same name.

For example, the ConsoleLoggerFactory.Dispose) is defined two times in a single page and hence have two sections: #dispose and #dispose-1.

With our current implementation, we'd always produce a reference to the first method even if we meant the second one.