Multi-line comments are more readable when each line is aligned using the "*" character. At most one violation is created for each comment == Noncompliant Code Example [source,sql] ---- /* this line is not aligned and ugly Non-Compliant no violation is created on this line, even though is it also bad */ /* this is Compliant */ ---- == Compliant Solution [source,sql] ---- /* * this is much better Compliant */ /* this is Compliant */ ---- ifdef::env-github,rspecator-view[] ''' == Implementation Specification (visible only on this page) include::message.adoc[] endif::env-github,rspecator-view[]