SONARJAVA-5445 S1123 Add tests for markdown JavaDoc (#5149)

Author: tomasz-tylenda-sonarsource

java-checks-test-sources/default/src/main/java/checks/MissingDeprecatedCheckMarkdownSample.java

@@ -0,0 +1,20 @@
+package checks;
+
+class MissingDeprecatedCheckMarkdownSample {
+
+  @Deprecated(since = "R1.3")
+  public void annotated() {} // Noncompliant
+
+  /// Markdown doc, but not tag.
+  @Deprecated(since = "R1.3")
+  public void annotatedJavaDoc() {} // Noncompliant
+
+  /// Markdown doc with a tag.
+  /// @deprecated for a good reason
+  @Deprecated(since = "R1.3")
+  public void annotatedJavaDocTag() {} // Compliant
+
+  /// Markdown doc with a tag.
+  /// @deprecated for a good reason
+  public void justTag() {} // Noncompliant
+}

java-checks/src/test/java/org/sonar/java/checks/MissingDeprecatedCheckTest.java

@@ -49,4 +49,11 @@ void test_records() {
       .verifyIssues();
   }
 
+  @Test
+  void test_markdown() {
+    CheckVerifier.newVerifier()
+      .onFile(mainCodeSourcesPath("checks/MissingDeprecatedCheckMarkdownSample.java"))
+      .withCheck(new MissingDeprecatedCheck())
+      .verifyIssues();
+  }
 }