diff --git a/src/docs/antora/modules/ROOT/pages/appendix.adoc b/src/docs/antora/modules/ROOT/pages/appendix.adoc
index f911a7ec..6b221f7a 100644
--- a/src/docs/antora/modules/ROOT/pages/appendix.adoc
+++ b/src/docs/antora/modules/ROOT/pages/appendix.adoc
@@ -56,6 +56,7 @@
 |`spring.modulith.republish-outstanding-events-on-restart`
 |`false`
 |Whether to republish outstanding event publications on restarts of the application.
+Usually not recommended in multi-instance deployments as other instances might still be processing events.
 |===
 
 [appendix]
diff --git a/src/docs/antora/modules/ROOT/pages/events.adoc b/src/docs/antora/modules/ROOT/pages/events.adoc
index 0742e61a..ec549172 100644
--- a/src/docs/antora/modules/ROOT/pages/events.adoc
+++ b/src/docs/antora/modules/ROOT/pages/events.adoc
@@ -204,7 +204,7 @@ image::event-publication-registry-start.png[]
 
 Each transactional event listener is wrapped into an aspect that marks that log entry as completed if the execution of the listener succeeds.
 In case the listener fails, the log entry stays untouched so that retry mechanisms can be deployed depending on the application's needs.
-By default, all incomplete event publications are resubmitted at application startup.
+Automatic re-publication of the events can be enabled via the xref:appendix.adoc#configuration-properties[`spring.modulith.republish-outstanding-events-on-restart`] property.
 
 .The transactional event listener arrangement after execution
 image::event-publication-registry-end.png[]