diff --git a/akka-persistence-typed/src/main/scala/akka/persistence/typed/javadsl/RetentionCriteria.scala b/akka-persistence-typed/src/main/scala/akka/persistence/typed/javadsl/RetentionCriteria.scala
index 5661b2cf03..fee6bdea4d 100644
--- a/akka-persistence-typed/src/main/scala/akka/persistence/typed/javadsl/RetentionCriteria.scala
+++ b/akka-persistence-typed/src/main/scala/akka/persistence/typed/javadsl/RetentionCriteria.scala
@@ -33,8 +33,8 @@ object RetentionCriteria {
    * Use [[SnapshotCountRetentionCriteria.withDeleteEventsOnSnapshot]] to
    * delete old events. Events are not deleted by default.
    *
-   * If multiple events are persisted with a persist the snapshot will happen after
-   * all of the events are persisted rather than precisely every numberOfEvents
+   * If multiple events are persisted with a single Effect, the snapshot will happen after
+   * all of the events are persisted rather than precisely every `numberOfEvents`.
    */
   def snapshotEvery(numberOfEvents: Int, keepNSnapshots: Int): SnapshotCountRetentionCriteria =
     SnapshotCountRetentionCriteriaImpl(numberOfEvents, keepNSnapshots, deleteEventsOnSnapshot = false)
diff --git a/akka-persistence-typed/src/main/scala/akka/persistence/typed/scaladsl/RetentionCriteria.scala b/akka-persistence-typed/src/main/scala/akka/persistence/typed/scaladsl/RetentionCriteria.scala
index 182b1797b8..fd7df34b5c 100644
--- a/akka-persistence-typed/src/main/scala/akka/persistence/typed/scaladsl/RetentionCriteria.scala
+++ b/akka-persistence-typed/src/main/scala/akka/persistence/typed/scaladsl/RetentionCriteria.scala
@@ -34,7 +34,7 @@ object RetentionCriteria {
    * delete old events. Events are not deleted by default.
    *
    * If multiple events are persisted with a single Effect the snapshot will happen after
-   * all of the events are persisted rather than precisely every numberOfEvents
+   * all of the events are persisted rather than precisely every `numberOfEvents`.
    */
   def snapshotEvery(numberOfEvents: Int, keepNSnapshots: Int): SnapshotCountRetentionCriteria =
     SnapshotCountRetentionCriteriaImpl(numberOfEvents, keepNSnapshots, deleteEventsOnSnapshot = false)