diff --git a/polkadot/roadmap/implementers-guide/src/types/approval.md b/polkadot/roadmap/implementers-guide/src/types/approval.md
index 1f44dc43ff..07266e718a 100644
--- a/polkadot/roadmap/implementers-guide/src/types/approval.md
+++ b/polkadot/roadmap/implementers-guide/src/types/approval.md
@@ -2,11 +2,11 @@
 
 ## ApprovalId
 
-The public key of a keypair used by a validator for approval voting.
+The public key of a keypair used by a validator for approval voting on included parachain candidates.
 
 ## AssignmentId
 
-The private key of a keypair used by a validator for approval voting.
+The public key of a keypair used by a validator for determining assignments to approve included parachain candidates.
 
 ## AssignmentCert