diff --git a/libbeat/docs/shared-autodiscover.asciidoc b/libbeat/docs/shared-autodiscover.asciidoc
index 300da5da00c7..4b07e6a9e9ae 100644
--- a/libbeat/docs/shared-autodiscover.asciidoc
+++ b/libbeat/docs/shared-autodiscover.asciidoc
@@ -15,6 +15,9 @@ Autodiscover providers work by watching for events on the system and translating
 events with a common format. When you configure the provider, you can use fields from the autodiscover event to set
 conditions that, when met, launch specific configurations.
 
+On start, {beatname_uc} will scan existing containers and launch the proper configs for them. Then it will watch for new
+start/stop events. This ensures you don't need to worry about state, but only define your desired configs.
+
 [float]
 ===== Docker