Latest docs on successful build 6125 auto-pushed to gh-pages

bugpattern/RestrictedApi.md

@@ -13,8 +13,17 @@ To make changes, edit the @BugPattern annotation or the explanation in docs/bugp
 
 
 ## The problem
-Calls to APIs marked @RestrictedApi are prohibited without a corresponding
+Calls to APIs marked `@RestrictedApi` are prohibited without a corresponding
 allowlist annotation.
 
+The intended use-case for `@RestrictedApi` is to restrict calls to annotated
+methods so that each usage of those APIs must be reviewed separately. For
+example, an API might lead to security bugs unless the programmer uses it
+correctly.
+
+See the
+[javadoc for `@RestrictedApi`](https://errorprone.info/api/latest/com/google/errorprone/annotations/RestrictedApi.html)
+for more details.
+
 ## Suppression
 Suppress false positives by adding the suppression annotation `@SuppressWarnings("RestrictedApi")` to the enclosing element.