diff --git a/pallets/smith-members/src/lib.rs b/pallets/smith-members/src/lib.rs
index 181cf3281944daa84ab9d82ff63dddbd3e2169ee..4b7cc93352a36201a081d4d5646ae91c28988b33 100644
--- a/pallets/smith-members/src/lib.rs
+++ b/pallets/smith-members/src/lib.rs
@@ -280,6 +280,7 @@ pub mod pallet {
 
     #[pallet::call]
     impl<T: Config> Pallet<T> {
+        /// Invite a WoT member to try becoming a Smith
         #[pallet::call_index(0)]
         #[pallet::weight(T::WeightInfo::invite_smith())]
         pub fn invite_smith(
@@ -294,6 +295,7 @@ pub mod pallet {
             Ok(().into())
         }
 
+        /// Accept an invitation (must have been invited first)
         #[pallet::call_index(1)]
         #[pallet::weight(T::WeightInfo::accept_invitation())]
         pub fn accept_invitation(origin: OriginFor<T>) -> DispatchResultWithPostInfo {
@@ -305,6 +307,7 @@ pub mod pallet {
             Ok(().into())
         }
 
+        /// Certify an invited smith which can lead the certified to become a Smith
         #[pallet::call_index(2)]
         #[pallet::weight(T::WeightInfo::certify_smith())]
         pub fn certify_smith(