Enable "XML documentation file" in the SharpCompress project to enable Intellisense tooltips for users of the SharpCompress library #59

Open
opened 2026-01-29 22:05:56 +00:00 by claunia · 0 comments
Owner

Originally created by @elgonzo on GitHub (Sep 4, 2015).

I noticed in the SharpCompress.csproj project file, that the build setting "XML document file" is not set.
Enabling this setting and set the XML file name to the same as the library (i.e., "SharpCompress.xml") will generate a XML documentation file usable by Intellisense. Put it together with the library in the nuget package, and the users of the SharpCompress library will be able to see Intellisense tooltips with the method/field/class/etc. documentation comments you have already written in the source code...

(I am aware that not all public members of the SharpCompress classes have documentation comments. But many already have. And it would be a shame to not make them available through Intellisense...)

Originally created by @elgonzo on GitHub (Sep 4, 2015). I noticed in the SharpCompress.csproj project file, that the build setting "XML document file" is not set. Enabling this setting and set the XML file name to the same as the library (i.e., "SharpCompress.xml") will generate a XML documentation file usable by Intellisense. Put it together with the library in the nuget package, and the users of the SharpCompress library will be able to see Intellisense tooltips with the method/field/class/etc. documentation comments you have already written in the source code... (I am aware that not all public members of the SharpCompress classes have documentation comments. But many already have. And it would be a shame to not make them available through Intellisense...)
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/sharpcompress#59