diff --git a/ops/charm.py b/ops/charm.py index 46ee2db6b..42c94b292 100644 --- a/ops/charm.py +++ b/ops/charm.py @@ -1104,7 +1104,9 @@ class CollectStatusEvent(LifecycleEvent): The framework will trigger these events after the hook code runs successfully (``collect_app_status`` will only be triggered on the leader - unit). If any statuses were added by the event handler using + unit). This happens on every Juju event, whether it was + :meth:`observed ` or not. + If any statuses were added by the event handler using :meth:`add_status`, the framework will choose the highest-priority status and set that as the status (application status for ``collect_app_status``, or unit status for ``collect_unit_status``).