You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
In the above scenario, Quick Info shows "hi" and "hello", but not "second". SharpLab
We confirmed that the compiler APIs do include both elements, so we think that Quick Info is "dropping" the second remarks tag here. Should Quick Info change to somehow merge these?
The text was updated successfully, but these errors were encountered:
I can't find any indication in the specification to suggest that multiple <remarks> section elements are expected on a single code element. Considering that this is likely going to not be portable across documentation generation tools, it seems like the current IDE behavior reflects one reasonable interpretation of the presented code.
If we do make a change here, it should be coordinated across both the IDE and the known tools which process documentation files.
I think at least we should reach a set of recommendations for whether/how source generators can add documentation to user-declared symbols. It would be useful to know if we already have analyzers to warn against certain duplicate elements.
Related to dotnet/csharplang#6014
In the above scenario, Quick Info shows "hi" and "hello", but not "second". SharpLab
We confirmed that the compiler APIs do include both elements, so we think that Quick Info is "dropping" the second remarks tag here. Should Quick Info change to somehow merge these?
The text was updated successfully, but these errors were encountered: