diff --git a/core/src/main/java/com/google/errorprone/refaster/annotation/AfterTemplate.java b/core/src/main/java/com/google/errorprone/refaster/annotation/AfterTemplate.java
index 63018e3f465..53d23bb577d 100644
--- a/core/src/main/java/com/google/errorprone/refaster/annotation/AfterTemplate.java
+++ b/core/src/main/java/com/google/errorprone/refaster/annotation/AfterTemplate.java
@@ -25,6 +25,9 @@
  * Desired "after" version of a refactoring. Corresponds to a matching method annotated with {@link
  * BeforeTemplate}.
  *
+ * <p>Multiple {@code @AfterTemplate}s can be provided. This is useful in Tricorder findings, where
+ * multiple suggestions can be presented to the user.
+ *
  * @author lowasser@google.com (Louis Wasserman)
  */
 @Target(ElementType.METHOD)
diff --git a/core/src/main/java/com/google/errorprone/refaster/annotation/BeforeTemplate.java b/core/src/main/java/com/google/errorprone/refaster/annotation/BeforeTemplate.java
index 57082487d5f..08bf7ca499f 100644
--- a/core/src/main/java/com/google/errorprone/refaster/annotation/BeforeTemplate.java
+++ b/core/src/main/java/com/google/errorprone/refaster/annotation/BeforeTemplate.java
@@ -22,9 +22,11 @@
 import java.lang.annotation.Target;
 
 /**
- * Desired "before" version of a refactoring. Corresponds to a matching method annotated with {@link
+ * Desired "before" version of a refactoring. Corresponds to matching methods annotated with {@link
  * AfterTemplate}.
  *
+ * <p>Multiple {@code @BeforeTemplate}s can be provided to match multiple patterns.
+ *
  * @author lowasser@google.com (Louis Wasserman)
  */
 @Target(ElementType.METHOD)