[ResxSourceGenerator] Add a /// <summary /> comment to public and internal generated members

[dvoituron]

[ResxSourceGenerator] Add a /// <summary /> comment to public and internal generated members

See #7478

Analyzer

Microsoft.CodeAnalysis.ResxSourceGenerator

Describe the improvement

Add a /// <summary /> comment to public and internals generated members (classes and methods).

Example:

Describe suggestions on how to achieve the rule

I use this csproj configuration containing the <Public> flag to generate a public class.
My editorconfig rules require all public classes/methods to contain XML documentation.
So I get the following error “CS1592 Missing XML comment for publicly visible type or member ‘LanguageResource’”.
I can't add an exclusion to this file because it's not generated in my source folders (but in a temporary folder).

<ItemGroup>
  <PackageReference Include="Microsoft.CodeAnalysis.ResxSourceGenerator">
    <PrivateAssets>all</PrivateAssets>
    <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
  </PackageReference>
    
  <EmbeddedResource Update="Localization\LanguageResource.resx">
    <Public>true</Public>
    <OmitGetResourceString>true</OmitGetResourceString>
    <AsConstants>true</AsConstants>
  </EmbeddedResource>
</ItemGroup>

Unit Tests

All unit tests are updated to include these new <summary /> comments.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 96.50%. Comparing base (5435ba7) to head (3b41f40).

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #7479   +/-   ##
=======================================
  Coverage   96.50%   96.50%           
=======================================
  Files        1450     1450           
  Lines      347319   347325    +6     
  Branches    11409    11409           
=======================================
+ Hits       335184   335192    +8     
+ Misses       9244     9243    -1     
+ Partials     2891     2890    -1     

[uo1]

Duplicate to pull request #7366

[sharwell]

Duplicate of #7366