diff --git a/R/board_connect.R b/R/board_connect.R
index 731a3879..949f7593 100644
--- a/R/board_connect.R
+++ b/R/board_connect.R
@@ -30,9 +30,17 @@
 #' ))
 #' board %>% pin_read("numbers")
 #' ```
-#'
+#' 
 #' You can find the URL of a pin with [pin_browse()].
 #'
+#' # Local caching for Posit Connect
+#' 
+#' The pins package maintains local per-session caches for _users_ and _content_ 
+#' from your Connect server. If your cache gets into a bad state (for example, 
+#' user names have changed on the server or a pin was deleted on the server, but 
+#' your local machine doesn't know about the change yet), you can clear your 
+#' local cache by restarting your R session.
+#'
 #' @inheritParams new_board
 #' @inheritParams board_url
 #' @param auth There are three ways to authenticate:
diff --git a/man/board_connect.Rd b/man/board_connect.Rd
index f5fb2242..0c8592b4 100644
--- a/man/board_connect.Rd
+++ b/man/board_connect.Rd
@@ -104,6 +104,14 @@ board \%>\% pin_read("numbers")
 You can find the URL of a pin with \code{\link[=pin_browse]{pin_browse()}}.
 }
 
+\section{Local caching for Posit Connect}{
+The pins package maintains local per-session caches for \emph{users} and \emph{content}
+from your Connect server. If your cache gets into a bad state (for example,
+user names have changed on the server or a pin was deleted on the server, but
+your local machine doesn't know about the change yet), you can clear your
+local cache by restarting your R session.
+}
+
 \examples{
 \dontrun{
 board <- board_connect()