From b1d3844626b9c37dfd8fdcb0da95f08ead75b87d Mon Sep 17 00:00:00 2001
From: Thomas Dinsdale-Young <ty@concordium.com>
Date: Fri, 16 Aug 2024 13:14:18 +0200
Subject: [PATCH] Address review comments.

---
 src/types/mod.rs | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/src/types/mod.rs b/src/types/mod.rs
index e9bad0d02..ca2840b48 100644
--- a/src/types/mod.rs
+++ b/src/types/mod.rs
@@ -2032,7 +2032,10 @@ pub enum DelegationEvent {
         delegator_id: DelegatorId,
     },
     BakerRemoved {
-        /// Baker's id
+        /// The id of the baker that was removed. If the account is a baker in
+        /// the current payday, it will remain so until the next payday,
+        /// although the baker record will be removed from the account
+        /// immediately.
         baker_id: BakerId,
     },
 }
@@ -2101,7 +2104,10 @@ pub enum BakerEvent {
     },
     /// Removed an existing delegator
     DelegationRemoved {
-        /// Delegator's id
+        /// The id of the delegator that was removed. If the account is a
+        /// delegator in the current payday, it will remain so until the
+        /// next payday, although the delegation record will be removed
+        /// from the account immediately.
         delegator_id: DelegatorId,
     },
 }