diff --git a/lib/public/User/Events/BeforeUserIdUnassignedEvent.php b/lib/public/User/Events/BeforeUserIdUnassignedEvent.php
index 744ecd8909f..2dee62521aa 100644
--- a/lib/public/User/Events/BeforeUserIdUnassignedEvent.php
+++ b/lib/public/User/Events/BeforeUserIdUnassignedEvent.php
@@ -3,7 +3,7 @@
 declare(strict_types=1);
 
 /**
- * SPDX-FileCopyrightText: 2019 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-FileCopyrightText: 2024 Nextcloud GmbH and Nextcloud contributors
  * SPDX-License-Identifier: AGPL-3.0-or-later
  */
 
@@ -12,6 +12,7 @@ namespace OCP\User\Events;
 use OCP\EventDispatcher\Event;
 
 /**
+ * Emitted before removing the mapping between an external user and an internal userid
  * @since 31.0.0
  */
 class BeforeUserIdUnassignedEvent extends Event {
@@ -19,7 +20,7 @@ class BeforeUserIdUnassignedEvent extends Event {
 	 * @since 31.0.0
 	 */
 	public function __construct(
-		private string $userId,
+		private readonly string $userId,
 	) {
 		parent::__construct();
 	}
diff --git a/lib/public/User/Events/UserIdAssignedEvent.php b/lib/public/User/Events/UserIdAssignedEvent.php
index 63daca09820..829bd50c0d0 100644
--- a/lib/public/User/Events/UserIdAssignedEvent.php
+++ b/lib/public/User/Events/UserIdAssignedEvent.php
@@ -3,7 +3,7 @@
 declare(strict_types=1);
 
 /**
- * SPDX-FileCopyrightText: 2019 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-FileCopyrightText: 2024 Nextcloud GmbH and Nextcloud contributors
  * SPDX-License-Identifier: AGPL-3.0-or-later
  */
 
@@ -12,6 +12,7 @@ namespace OCP\User\Events;
 use OCP\EventDispatcher\Event;
 
 /**
+ * Emitted by backends (like user_ldap) when a user created externally is mapped for the first time and assigned a userid
  * @since 31.0.0
  */
 class UserIdAssignedEvent extends Event {
@@ -19,7 +20,7 @@ class UserIdAssignedEvent extends Event {
 	 * @since 31.0.0
 	 */
 	public function __construct(
-		private string $userId,
+		private readonly string $userId,
 	) {
 		parent::__construct();
 	}
diff --git a/lib/public/User/Events/UserIdUnassignedEvent.php b/lib/public/User/Events/UserIdUnassignedEvent.php
index db8861b98a4..128648a0753 100644
--- a/lib/public/User/Events/UserIdUnassignedEvent.php
+++ b/lib/public/User/Events/UserIdUnassignedEvent.php
@@ -3,7 +3,7 @@
 declare(strict_types=1);
 
 /**
- * SPDX-FileCopyrightText: 2019 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-FileCopyrightText: 2024 Nextcloud GmbH and Nextcloud contributors
  * SPDX-License-Identifier: AGPL-3.0-or-later
  */
 
@@ -12,6 +12,7 @@ namespace OCP\User\Events;
 use OCP\EventDispatcher\Event;
 
 /**
+ * Emitted after removing the mapping between an external user and an internal userid
  * @since 31.0.0
  */
 class UserIdUnassignedEvent extends Event {
@@ -19,7 +20,7 @@ class UserIdUnassignedEvent extends Event {
 	 * @since 31.0.0
 	 */
 	public function __construct(
-		private string $userId,
+		private readonly string $userId,
 	) {
 		parent::__construct();
 	}