Relative Content

Tag Archive for c#xmldocumentation

C# XML documentation: dealing with the entirety

In recent times I annotated my entire large C# project with XML documentation, and I also made heavy use of the inheritdoc notation (for example when we are overriding a base class method).
Imagine my surprise and horror when I looked at the resulting XML and found that it actually said “inheritdoc”. That is: the XML didn’t inherit the text (the whole point of doing this) but just put an inherit element in there.

C# XML documentation: dealing with the entirety

In recent times I annotated my entire large C# project with XML documentation, and I also made heavy use of the inheritdoc notation (for example when we are overriding a base class method).
Imagine my surprise and horror when I looked at the resulting XML and found that it actually said “inheritdoc”. That is: the XML didn’t inherit the text (the whole point of doing this) but just put an inherit element in there.