roslynator icon indicating copy to clipboard operation
roslynator copied to clipboard

Mute RCS1253 (summary on one line) when not applicable?

Open jafaber opened this issue 9 months ago • 1 comments

Having the preference for

configured to single line using:

roslynator_doc_comment_summary_style = single_line

Can RCS1253 be muted when the summary is longer than N characters and/or when the <summary> contains one of <para>, <list>, <br> (or possibly some others) ?

jafaber avatar Feb 16 '25 12:02 jafaber

Hi,

I'd split this issue into two parts:

  • Do not suggest to convert multiline comment into singleline when a comment contains <para> etc.
    • this is basically a bug and should be fixed
  • Do not suggest to convert multiline comment into singleline when a comment text is longer than x characters
    • this could be accomplished by providing some kind of an options like roslynator_doc_comment_single_line_summary_max_length and probably should work both ways, i.e. multi to single and single to multi based on comment length.

josefpihrt avatar Mar 01 '25 10:03 josefpihrt