diff --git a/scenario/context.py b/scenario/context.py
index cb5331d5..8c7d271c 100644
--- a/scenario/context.py
+++ b/scenario/context.py
@@ -167,7 +167,7 @@ def config_changed():
         return _Event("config_changed")
 
     @staticmethod
-    @_copy_doc(ops.UpdateStatusEvent)
+    @_copy_doc(ops.UpgradeCharmEvent)
     def upgrade_charm():
         return _Event("upgrade_charm")
 
diff --git a/scenario/state.py b/scenario/state.py
index 9179735d..09d1895a 100644
--- a/scenario/state.py
+++ b/scenario/state.py
@@ -824,7 +824,7 @@ class Notice(_max_posargs(1)):
     last_repeated: datetime.datetime = dataclasses.field(default_factory=_now_utc)
     """The time this notice was last repeated.
 
-    See Pebble's `Notices documentation <https://github.com/canonical/pebble/#notices>`_
+    See Pebble's `Notices documentation <https://canonical-pebble.readthedocs-hosted.com/en/latest/reference/notices/>`_
     for an explanation of what "repeated" means.
     """