Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Add XML documentation for named elements in ValueTuple

With ValueTuple in C# 7, it is now possible to write methods and properties that return or consume composite objects without explicitly declaring a type. These named tuples can however be potentially confusing when no documentation is provided.

As the primary and probably most convenient way of documenting libraries is by using XML documentation, is there any way using XML documentation to provide a description of the variables in a named tuple?

I know the obvious solution is to declare a type and document it accordingly. However, granted that due to some 'reasons' that cannot be done, is it possible to XML document the data members in a ValueTuple?

NB: A similar question was asked before the advent of the ValueTuple.

like image 966
Alex Essilfie Avatar asked May 06 '18 09:05

Alex Essilfie


1 Answers

C# has no special syntax for documenting named elements of a tuple, you will have to use the normal <returns> and <param> elements and explain in words what each named element contains.

Though there is a proposal for adding this capability to the language.

like image 55
svick Avatar answered Oct 09 '22 20:10

svick