Комментарии XML - следует ли видеть, что ссылки должны быть полностью квалифицированными?

В принципе, когда действительно необходимо (если вообще) использовать полный XML-код, см. ссылку:

<see cref="T:MyNamespace.Sub.MyType"/> //Option 1
<see cref="T:MyType"> //Option 2

Также, что насчет ссылки на объекты .NET Framework?

<see cref="T:System.Collections.Generic.ICollection{T}"/> //Option 1
<see cref="T:ICollection{T}"/> //Option 2

Я понимаю, что полностью подходящие элементы всегда позволяют Microsoft Sandcastle правильно связывать вещи, но необходимо ли, чтобы все было полностью квалифицировано?


Sidenote: сможет ли Microsoft Sandcastle связать к файлам справки .NET Framework, или я зря трачу время, ссылаясь на ?

24
задан m-y 13 May 2011 в 15:56
поделиться