diff --git a/src/main/java/org/fuin/units4j/AssertCoverage.java b/src/main/java/org/fuin/units4j/AssertCoverage.java
index ab17a12..0c2d582 100644
--- a/src/main/java/org/fuin/units4j/AssertCoverage.java
+++ b/src/main/java/org/fuin/units4j/AssertCoverage.java
@@ -38,10 +38,10 @@
  *
  * @deprecated Use <a href="https://www.archunit.org/">ArchUnit</a> rules instead.
  *
- * <code>
- * @AnalyzeClasses(packagesOf = AClassInRootPackage.class, importOptions = ImportOption.DoNotIncludeTests.class)
+ * <code>{@code
+ * &#64;AnalyzeClasses(packagesOf = AClassInRootPackage.class, importOptions = ImportOption.DoNotIncludeTests.class)
  * class ArchitectureTest {
- *     @ArchTest
+ *     &#64;ArchTest
  *     static final ArchRule all_classes_should_have_tests =
  *         classes()
  *             .that()
@@ -52,8 +52,8 @@
  *                 .and().doNotHaveModifier(JavaModifier.ABSTRACT)
  *                 .and().areNotAnnotatedWith(ArchIgnore.class)
  *                 .should(haveACorrespondingClassEndingWith("Test"));
- * </code>
- *
+ * }
+ * }</code>
  */
 @Deprecated
 public final class AssertCoverage {
diff --git a/src/main/java/org/fuin/units4j/AssertDependencies.java b/src/main/java/org/fuin/units4j/AssertDependencies.java
index a172ce4..f2656c8 100644
--- a/src/main/java/org/fuin/units4j/AssertDependencies.java
+++ b/src/main/java/org/fuin/units4j/AssertDependencies.java
@@ -34,8 +34,8 @@
  * @deprecated Use <a href="https://www.archunit.org/">ArchUnit</a> rules instead.
  *
  * Example ArchUnit test rule:
- * <code>
- * @ArchTest
+ * <pre>{@code
+ * &#64;ArchTest
  * static final ArchRule core_access_only_to_defined_packages =
  *     classes()
  *         .that()
@@ -43,7 +43,7 @@
  *         .should()
  *             .onlyDependOnClassesThat()
  *             .resideInAnyPackage("my.package.common..", "java.lang..");
- * </code>
+ * }</pre>
  */
 @Deprecated
 public final class AssertDependencies {