diff --git a/src/proto_alpha/lib_protocol/adaptive_issuance_services.ml b/src/proto_alpha/lib_protocol/adaptive_issuance_services.ml
index 59d1f473dc5c43fd14ab60991fd7a2ece17888ff..2907d0a2434f8ae87b50db50a1445153a95f1618 100644
--- a/src/proto_alpha/lib_protocol/adaptive_issuance_services.ml
+++ b/src/proto_alpha/lib_protocol/adaptive_issuance_services.ml
@@ -148,7 +148,7 @@ module S = struct
     RPC_service.get_service
       ~description:
         "Returns the expected issued tez for the provided block and the next \
-         three cycles"
+         'consensus_rights_delay' cycles"
       ~query:RPC_query.empty
       ~output:(Data_encoding.list expected_rewards_encoding)
       RPC_path.(path / "expected_issuance")
diff --git a/src/proto_alpha/lib_protocol/delegate_slashed_deposits_storage.mli b/src/proto_alpha/lib_protocol/delegate_slashed_deposits_storage.mli
index 83d4d2f09930d9d4cd966df9649f198bd98277c2..02e0705ade682174e5f0f76670837474b4cdc191 100644
--- a/src/proto_alpha/lib_protocol/delegate_slashed_deposits_storage.mli
+++ b/src/proto_alpha/lib_protocol/delegate_slashed_deposits_storage.mli
@@ -25,10 +25,14 @@
 (*                                                                           *)
 (*****************************************************************************)
 
-(** This module maintains the storage related to slashing of delegates for
-   double signing. In particular, it is responsible for maintaining the
-   {!Storage.Already_denounced}, {!Storage.Contract.Slashed_deposits}, and
-   {!Storage.Pending_denunciations} tables.
+(** This module handles the slashing of delegates for double signing.
+
+    It is behind the {!Alpha_context} abstraction: some functions are
+    re-exported in {!Alpha_context.Delegate}.
+
+    This module is responsible for maintaining the
+    {!Storage.Contract.Slashed_deposits} table. It also interacts
+    heavily with {!Pending_denunciations_storage}.
 *)
 
 (** The [reward_and_burn] type embeds amounts involved when slashing a