0
393
ViewsShow comments in nuget package
How do I include the comments that I write above my methods and properties in my nuget package? Ie. So when the library is consumed the user can use intellisense and read what the method is about?
eg. if I have the method
/// <summary>
/// This method does such and such
/// </summary>
public void SomeMethod()
{
// does something..
}
Then I want to user to be able to see "This method does such and such" as they type the method.
2 answers
Answer question0
For .NET Core and recent versions of VisualStudio, checking "XML Documentation file" will add an absolute path, as discussed here. This appears to be a bug, and it's preventing NuGet packages from including documentation.
The solution is to add the following to the .csproj file, and un-check the "XML Documentation file" box.
<PropertyGroup>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>
A target was recently added to the SDK so that if this value is true, and DocumentationFile is empty (i.e., the checkbox is not set in Visual Studio), it will just "do the right thing" and generate the documentation file in the output folder that NuGet expects.
There is currently no way to do this from the Visual Studio UI; a request to make that change is still being discussed as of the time of this writing.
Update: It looks like the setting for this is now available as a preview feature in Visual Studio.
