C#: How to reference generic classes and methods in xml documentation

Question

When writing xml documentation you can use <see cref="something">something</see>, which works of course. But how do you reference a class or a method with generic types?

public class FancyClass<T>
{
  public string FancyMethod<K>(T value) { return "something fancy"; }
}

If I was going to write xml documentation somewhere, how would I reference the fancy class? how can I reference a FancyClass? What about the method?

For example in a different class I wanted to let the user know that I will return an instance of FancyClass. How could I make a see cref thing for that?

Answer 1

/// <summary>Uses a <see cref="FancyClass{T}" /> instance.</summary>

BTW, it was present in the MSDN documentation of .Net Framework 2.0 and 3.0, but it disapeared in the version 3.5

Answer 2

To reference the method:

/// <see cref="FancyClass{T}.FancyMethod{K}(T)"/> for more information.