ReSharper cannot allow collection type in comments

Question

ReSharper has problems resolving the collection name if it appears in the description of the method referenced by cref .

For example, in this signature, ReSharper emphasizes the word Dictionary :

 /// <summary> /// The reconstruct in single account. /// </summary> /// <param name="programId"> /// The program id. /// </param> /// <returns> /// The <see cref="Dictionary"/>. // <-- here the "Dictionary" is underlined /// </returns> Dictionary<long, Account> ReconstructInSingleAccount(long programId) { } 

When I hover over a selection, it says Cannot resolve symbol 'Dictionary' . The file has a link to System.Collections.Generic . The same thing happens for IEnumerable and for List .

It does not affect the code, does not interfere with compilation or anything else. However, I prefer my files to be cleaned up, and I don't think ReSharper had problems resolving names in comments in the first place.

I am using ReSharper 8.0. Any suggestion on how to fix this or how to modify my comments to get rid of this “unresolved” warning was greatly appreciated.

Answer 1

XML comments have special syntax for calling generics:

 /// The <see cref="Dictionary{TKey,TValue}"/>