Hey #dotnet #csharp mastodon, serious question/curiosity.

Take a look at the List.cs file at https://github.com/dotnet/runtime/blob/main/src/libraries/System.Private.CoreLib/src/System/Collections/Generic/List.cs

Where the hell are the XML documentation tags (like <summary>)?

What sorcery is being done to remove them from code but still have them generate for intellesense?

runtime/List.cs at main · dotnet/runtime

.NET is a cross-platform runtime for cloud, mobile, desktop, and IoT apps. - runtime/List.cs at main · dotnet/runtime

GitHub
@aristurtle it's a bit weird that some methods (like on line 426) do have xml comments

@dost I think I may be on to something https://github.com/dotnet/runtime/blob/main/eng/intellisense.targets

Ultimately what I'm seeing is that yes, they do keep the XML documentation in a separate file and possibly just use some external editor to update it (cause no one is typing all that out by hand including the fully-qualified member names)

So it seems to be as simple as that, now to find an editor or make my own D:

runtime/intellisense.targets at main · dotnet/runtime

.NET is a cross-platform runtime for cloud, mobile, desktop, and IoT apps. - runtime/intellisense.targets at main · dotnet/runtime

GitHub
@aristurtle too bad it's not an awesome magic trick that can be reused