diff --git a/api/latest/com/google/errorprone/refaster/annotation/AfterTemplate.html b/api/latest/com/google/errorprone/refaster/annotation/AfterTemplate.html
index b2a70a25a25..da408657737 100644
--- a/api/latest/com/google/errorprone/refaster/annotation/AfterTemplate.html
+++ b/api/latest/com/google/errorprone/refaster/annotation/AfterTemplate.html
@@ -71,7 +71,10 @@ <h1 title="Annotation Type AfterTemplate" class="title">Annotation Type AfterTem
 <div class="type-signature"><span class="annotations"><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/Target.html" title="class or interface in java.lang.annotation" class="external-link">@Target</a>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/ElementType.html#METHOD" title="class or interface in java.lang.annotation" class="external-link">METHOD</a>)
 <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/Retention.html" title="class or interface in java.lang.annotation" class="external-link">@Retention</a>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/RetentionPolicy.html#SOURCE" title="class or interface in java.lang.annotation" class="external-link">SOURCE</a>)
 </span><span class="modifiers">public @interface </span><span class="element-name type-name-label">AfterTemplate</span></div>
-<div class="block">Desired "after" version of a refactoring. Corresponds to a matching method annotated with <a href="BeforeTemplate.html" title="annotation in com.google.errorprone.refaster.annotation"><code>BeforeTemplate</code></a>.</div>
+<div class="block">Desired "after" version of a refactoring. Corresponds to a matching method annotated with <a href="BeforeTemplate.html" title="annotation in com.google.errorprone.refaster.annotation"><code>BeforeTemplate</code></a>.
+
+ <p>Multiple <code>@AfterTemplate</code>s can be provided. This is useful in Tricorder findings, where
+ multiple suggestions can be presented to the user.</div>
 <dl class="notes">
 <dt>Author:</dt>
 <dd>lowasser@google.com (Louis Wasserman)</dd>
diff --git a/api/latest/com/google/errorprone/refaster/annotation/BeforeTemplate.html b/api/latest/com/google/errorprone/refaster/annotation/BeforeTemplate.html
index 81e4ed43798..49308f73260 100644
--- a/api/latest/com/google/errorprone/refaster/annotation/BeforeTemplate.html
+++ b/api/latest/com/google/errorprone/refaster/annotation/BeforeTemplate.html
@@ -71,7 +71,9 @@ <h1 title="Annotation Type BeforeTemplate" class="title">Annotation Type BeforeT
 <div class="type-signature"><span class="annotations"><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/Target.html" title="class or interface in java.lang.annotation" class="external-link">@Target</a>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/ElementType.html#METHOD" title="class or interface in java.lang.annotation" class="external-link">METHOD</a>)
 <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/Retention.html" title="class or interface in java.lang.annotation" class="external-link">@Retention</a>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/RetentionPolicy.html#SOURCE" title="class or interface in java.lang.annotation" class="external-link">SOURCE</a>)
 </span><span class="modifiers">public @interface </span><span class="element-name type-name-label">BeforeTemplate</span></div>
-<div class="block">Desired "before" version of a refactoring. Corresponds to a matching method annotated with <a href="AfterTemplate.html" title="annotation in com.google.errorprone.refaster.annotation"><code>AfterTemplate</code></a>.</div>
+<div class="block">Desired "before" version of a refactoring. Corresponds to matching methods annotated with <a href="AfterTemplate.html" title="annotation in com.google.errorprone.refaster.annotation"><code>AfterTemplate</code></a>.
+
+ <p>Multiple <code>@BeforeTemplate</code>s can be provided to match multiple patterns.</div>
 <dl class="notes">
 <dt>Author:</dt>
 <dd>lowasser@google.com (Louis Wasserman)</dd>