From 130918e45c9e10ac3ee8c5f31121336badb58de4 Mon Sep 17 00:00:00 2001
From: Edward Klimoshenko <eklimo@google.com>
Date: Fri, 26 Aug 2022 00:29:14 +0000
Subject: [PATCH] Add documentation for `VALID_ANNOTATION_NAMES`

---
 .../pmd/lang/apex/ast/ASTAnnotation.java       | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/pmd-apex/src/main/java/net/sourceforge/pmd/lang/apex/ast/ASTAnnotation.java b/pmd-apex/src/main/java/net/sourceforge/pmd/lang/apex/ast/ASTAnnotation.java
index cf4814603d..6d301566d1 100644
--- a/pmd-apex/src/main/java/net/sourceforge/pmd/lang/apex/ast/ASTAnnotation.java
+++ b/pmd-apex/src/main/java/net/sourceforge/pmd/lang/apex/ast/ASTAnnotation.java
@@ -16,6 +16,24 @@ import com.google.summit.ast.modifier.AnnotationModifier;
 
 public class ASTAnnotation extends AbstractApexNode.Single<AnnotationModifier> {
 
+    /**
+     * Valid annotations in the Apex language.
+     * <p>
+     * Includes all annotations from the <a href="https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_classes_annotation.htm">official
+     * documentation</a>, plus
+     * <ul>
+     *     <li>{@code AllowCertifiedApex}</li>
+     *     <li>{@code HiddenFromDoc}</li>
+     *     <li>{@code NamespaceGuard}</li>
+     *     <li>{@code PermGuard}</li>
+     *     <li>{@code PrivateApi}</li>
+     *     <li>{@code SfdcOnly}</li>
+     *     <li>{@code UseConnectDeserializer}</li>
+     *     <li>{@code UseConnectSerializer}</li>
+     *     <li>{@code VisibleApiVersion}</li>
+     * </ul>
+     * for backward compatibility.
+     */
     private static final ImmutableSet<String> VALID_ANNOTATION_NAMES = ImmutableSet.of(
             "allowcertifiedapex",
             "auraenabled",