diff --git a/src/proto_alpha/lib_protocol/bootstrap_storage.mli b/src/proto_alpha/lib_protocol/bootstrap_storage.mli
index 3b72ec8ca94088fdad17e244c9d9a2040718176a..91cfc6967c61b9a5143bce58c64c7a251fcd8d06 100644
--- a/src/proto_alpha/lib_protocol/bootstrap_storage.mli
+++ b/src/proto_alpha/lib_protocol/bootstrap_storage.mli
@@ -2,6 +2,7 @@
 (*                                                                           *)
 (* Open Source License                                                       *)
 (* Copyright (c) 2018 Dynamic Ledger Solutions, Inc. <contact@tezos.com>     *)
+(* Copyright (c) 2022 Nomadic Labs <contact@nomadic-labs.com>                *)
 (*                                                                           *)
 (* Permission is hereby granted, free of charge, to any person obtaining a   *)
 (* copy of this software and associated documentation files (the "Software"),*)
@@ -23,6 +24,10 @@
 (*                                                                           *)
 (*****************************************************************************)
 
+(** This module provides functions that can be used in a private network to
+    delay initial rewarding, typically when waiting for more bakers to join the
+    network. *)
+
 val init :
   Raw_context.t ->
   typecheck:
diff --git a/src/proto_alpha/lib_protocol/commitment_repr.mli b/src/proto_alpha/lib_protocol/commitment_repr.mli
index edca4134d844a163dfbdf9708af1797acfcfa46a..e9a5d5db3103dc44186754526779833bc6f680d9 100644
--- a/src/proto_alpha/lib_protocol/commitment_repr.mli
+++ b/src/proto_alpha/lib_protocol/commitment_repr.mli
@@ -2,6 +2,7 @@
 (*                                                                           *)
 (* Open Source License                                                       *)
 (* Copyright (c) 2018 Dynamic Ledger Solutions, Inc. <contact@tezos.com>     *)
+(* Copyright (c) 2022 Nomadic Labs <contact@nomadic-labs.com>                *)
 (*                                                                           *)
 (* Permission is hereby granted, free of charge, to any person obtaining a   *)
 (* copy of this software and associated documentation files (the "Software"),*)
@@ -23,6 +24,8 @@
 (*                                                                           *)
 (*****************************************************************************)
 
+(** This type represents a commitment to an amount of tokens which can be claimed
+    by a fund raiser after the blockchain is deployed. *)
 type t = {
   blinded_public_key_hash : Blinded_public_key_hash.t;
   amount : Tez_repr.t;
diff --git a/src/proto_alpha/lib_protocol/delegate_activation_storage.mli b/src/proto_alpha/lib_protocol/delegate_activation_storage.mli
index 28f43fcf597aca9b9fb23374851ecc0d45526832..9f5f0e47969a3771355a3675b1462c3581fad6ba 100644
--- a/src/proto_alpha/lib_protocol/delegate_activation_storage.mli
+++ b/src/proto_alpha/lib_protocol/delegate_activation_storage.mli
@@ -23,6 +23,13 @@
 (*                                                                           *)
 (*****************************************************************************)
 
+(** This module provides functions related to delegates' activity.
+
+    Typically, they can be used to deactivate a delegate that has not shown
+    activity for a certain number of cycles, and to reactivate it when
+    appropriate.
+*)
+
 val is_inactive :
   Raw_context.t -> Signature.Public_key_hash.t -> bool tzresult Lwt.t