Add some xml comments

[danmoseley]

Mostly with regex, then I ended up replacing the text with what's in the docs so they can sync one day.

There are still ~100 more files with the old style comments (and many more that don't have XML comments that match the docs) .. perhaps someone in the community is interested in doing more.

[ghost]

Tagging subscribers to this area: @dotnet/area-meta
See info in area-owners.md if you want to be subscribed.

Issue Details

---

Mostly with regex, then I ended up replacing the text with what's in the docs so they can sync one day.

There are still ~100 more files with the old style comments (and many more that don't have XML comments that match the docs) .. perhaps someone in the community is interested in doing more.

Author:	danmoseley
Assignees:	danmoseley
Labels:	area-Meta
Milestone:	-

[danmoseley]

OK, done most of the rest. (Not sure why.)

[danmoseley]

@carlossanlop would you perhaps have a few mins to sign off?

what is the state of your tool/script for porting doc comments into sources? are there working instructions? perhaps I could push this a long a bit at a time in corelib, during coffee breaks so to speak, and do whatever manual fixups as we go. In a few cases the code comment may be better, but I'm guessing that's not many. then we'd slowly be progressing towards sources as doc sourceoftruth.

[carlossanlop]

Thanks for tagging me @danmoseley . Left a bunch of suggestions for you to consider.

The backporting tool (dotnet-api-docs to runtime) isn't fully working yet, but the other one is (runtime to dotnet-api-docs).

[danmoseley]

I'm most interested in this direction. I'd be happy to try a flaky/partial tool if you like, worst case I can't use the results.

[danmoseley]

all feedback addressed