PLUGINAPI-5 deprecate support of markdown for rule descriptions

[froque]

• requires Upgrade Sonar 9.9 LTS  #12
• https://sonarsource.atlassian.net/browse/PLUGINAPI-5 Deprecate markdown support for rule descriptions
• PLUGINAPI-5 deprecate support of markdown for rule descriptions SonarSource/sonar-plugin-api#21
• https://sonarsource.atlassian.net/browse/PLUGINAPI-6 Support well-structured rule description
• PLUGINAPI-6 Multiple sections for rules descriptions SonarSource/sonar-plugin-api#11
• https://github.com/SonarSource/sonar-plugin-api/releases/tag/9.6.0.104
• https://github.com/SonarSource/sonar-custom-plugin-example/blob/6c57bea6b03201ed4bdd47e903980b4668a0af69/src/main/java/org/sonarsource/plugins/example/rules/JavaRulesDefinition.java#L49

[froque]

❯ git diff                                                    
diff --git a/src/main/java/com/premiumminds/sonar/postgres/PostgresSqlRulesDefinition.java b/src/main/java/com/premiumminds/sonar/postgres/PostgresSqlRulesDefinition.java
index 422cbe4..0a35c50 100644
--- a/src/main/java/com/premiumminds/sonar/postgres/PostgresSqlRulesDefinition.java
+++ b/src/main/java/com/premiumminds/sonar/postgres/PostgresSqlRulesDefinition.java
@@ -28,8 +28,15 @@ import com.premiumminds.sonar.postgres.visitors.VisitorCheck;
 import org.sonar.api.rule.RuleKey;
 import org.sonar.api.rule.Severity;
 import org.sonar.api.rules.RuleType;
+import org.sonar.api.server.rule.RuleDescriptionSection;
 import org.sonar.api.server.rule.RulesDefinition;
 
+import static org.sonar.api.server.rule.RuleDescriptionSection.RuleDescriptionSectionKeys.ASSESS_THE_PROBLEM_SECTION_KEY;
+import static org.sonar.api.server.rule.RuleDescriptionSection.RuleDescriptionSectionKeys.HOW_TO_FIX_SECTION_KEY;
+import static org.sonar.api.server.rule.RuleDescriptionSection.RuleDescriptionSectionKeys.INTRODUCTION_SECTION_KEY;
+import static org.sonar.api.server.rule.RuleDescriptionSection.RuleDescriptionSectionKeys.RESOURCES_SECTION_KEY;
+import static org.sonar.api.server.rule.RuleDescriptionSection.RuleDescriptionSectionKeys.ROOT_CAUSE_SECTION_KEY;
+
 public class PostgresSqlRulesDefinition implements RulesDefinition {
 
     public static final String REPOSITORY = "postgres-repository";
@@ -73,6 +80,26 @@ public class PostgresSqlRulesDefinition implements RulesDefinition {
         repository.createRule(RULE_PREFER_ROBUST_STMTS.rule())
                 .setName("prefer-robust-stmts rule")
                 .setType(RuleType.BUG)
+                .addDescriptionSection(RuleDescriptionSection.builder()
+                        .sectionKey(INTRODUCTION_SECTION_KEY)
+                        .htmlContent("INTRODUCTION_SECTION_KEY: Generates an issue when Postgres SQL is not valid and fails to parse 2")
+                        .build())
+                .addDescriptionSection(RuleDescriptionSection.builder()
+                        .sectionKey(ROOT_CAUSE_SECTION_KEY)
+                        .htmlContent("ROOT_CAUSE_SECTION_KEY: Generates an issue when Postgres SQL is not valid and fails to parse 2")
+                        .build())
+                .addDescriptionSection(RuleDescriptionSection.builder()
+                        .sectionKey(ASSESS_THE_PROBLEM_SECTION_KEY)
+                        .htmlContent("ASSESS_THE_PROBLEM_SECTION_KEY: Generates an issue when Postgres SQL is not valid and fails to parse 2")
+                        .build())
+                .addDescriptionSection(RuleDescriptionSection.builder()
+                        .sectionKey(HOW_TO_FIX_SECTION_KEY)
+                        .htmlContent("HOW_TO_FIX_SECTION_KEY: Generates an issue when Postgres SQL is not valid and fails to parse 2")
+                        .build())
+                .addDescriptionSection(RuleDescriptionSection.builder()
+                        .sectionKey(RESOURCES_SECTION_KEY)
+                        .htmlContent("RESOURCES_SECTION_KEY: Generates an issue when Postgres SQL is not valid and fails to parse 2")
+                        .build())
                 .setMarkdownDescription(getClass().getResource("prefer-robust-stmts.md"));
 
         repository.createRule(RULE_CONCURRENTLY.rule())

[froque]

Wait for more plugins to provide better examples.