missing help for some source generator errors

[danmoseley]

https://learn.microsoft.com/en-us/dotnet/fundamentals/syslib-diagnostics/syslib1040-1049
https://learn.microsoft.com/en-us/dotnet/fundamentals/syslib-diagnostics/syslib1050-1069
https://learn.microsoft.com/en-us/dotnet/fundamentals/syslib-diagnostics/syslib1070-1089

exist, but nothing for the Com interop source generator eg SYSLIB1090 nor the Config source generator eg SYSLIB1100

the live list of what the implementation has is
https://github.com/dotnet/runtime/blob/main/docs/project/list-of-diagnostics.md?plain=1#L210

@gewarren not sure whether this issue should be here or dotnet/docs, as presumably dev need to supply the text.

related dotnet/runtime#85181

---

Associated WorkItem - 89919

[gewarren]

@danmoseley I think this should be transferred to the dotnet/docs repo.

[ghost]

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

Issue Details

---

https://learn.microsoft.com/en-us/dotnet/fundamentals/syslib-diagnostics/syslib1040-1049
https://learn.microsoft.com/en-us/dotnet/fundamentals/syslib-diagnostics/syslib1050-1069
https://learn.microsoft.com/en-us/dotnet/fundamentals/syslib-diagnostics/syslib1070-1089

exist, but nothing for the Com interop source generator eg SYSLIB1090 nor the Config source generator eg SYSLIB1100

the live list of what the implementation has is
https://github.com/dotnet/runtime/blob/main/docs/project/list-of-diagnostics.md?plain=1#L210

@gewarren not sure whether this issue should be here or dotnet/docs, as presumably dev need to supply the text.

related dotnet/runtime#85181

Author:	danmoseley
Assignees:	-
Labels:	area-System.Runtime, untriaged, needs-area-label
Milestone:	-

[danmoseley]

as mentioned in linked issue, the product should link to https://learn.microsoft.com/dotnet/fundamentals/syslib-diagnostics/<CODE>.md and docs should either have a page for each or use redirection to a different page that groups several.

this issue tracks adding the content, which should be supplied by the owners of the COM Interop source generator (@jkoritzinsky ?) and he configuration source generator (@layomia )

[gewarren]

I've created really basic documents - it would be great if more info could be added.

https://learn.microsoft.com/en-us/dotnet/fundamentals/syslib-diagnostics/syslib1090-1099
https://learn.microsoft.com/en-us/dotnet/fundamentals/syslib-diagnostics/syslib1100-1118

[danmoseley]

Cc @ericstj as owner of the config generator in case there is more to add.
Otherwise maybe we can close.

[ericstj]

@dotnet/area-extensions-configuration for configuration - folks can improve the doc if they see opportunity.

I see we're missing the ones added for options validation @dotnet/area-extensions-options and some new ones added for JSON @dotnet/area-system-text-json

https://github.com/dotnet/runtime/blob/bb3597aeaaeb87920b848e71a7b152a202e672bd/docs/project/list-of-diagnostics.md?plain=1#L238-L266

[danmoseley]

@jkoritzinsky do the interop ones look OK?

[tarekgh]

I have created a PR for options source gen conceptual doc #37681. I'll try to look at the diagnostics doc to see what is missing and add it.

[tarekgh]

I have created the PR #37686 to address the Configuration and Options diagnostics.

[tarekgh]

#37686 is not completed. Thanks @gewarren for your review and feedback

[gewarren]

AFAICT, all SYSLIB diagnostics are now documented.