Clarify behavior #1138

src/entity/active_model.rs

@@ -611,15 +611,15 @@ pub trait ActiveModelBehavior: ActiveModelTrait {
         <Self as ActiveModelTrait>::default()
     }
 
-    /// Will be called before saving
+    /// Will be called before `ActiveModel::insert`, `ActiveModel::update`, and `ActiveModel::save`
     async fn before_save<C>(self, db: &C, insert: bool) -> Result<Self, DbErr>
     where
         C: ConnectionTrait,
     {
         Ok(self)
     }
 
-    /// Will be called after saving
+    /// Will be called after `ActiveModel::insert`, `ActiveModel::update`, and `ActiveModel::save`
     async fn after_save<C>(
         model: <Self::Entity as EntityTrait>::Model,
         db: &C,
@@ -631,15 +631,15 @@ pub trait ActiveModelBehavior: ActiveModelTrait {
         Ok(model)
     }
 
-    /// Will be called before deleting
+    /// Will be called before `ActiveModel::delete`
     async fn before_delete<C>(self, db: &C) -> Result<Self, DbErr>
     where
         C: ConnectionTrait,
     {
         Ok(self)
     }
 
-    /// Will be called after deleting
+    /// Will be called after `ActiveModel::delete`
     async fn after_delete<C>(self, db: &C) -> Result<Self, DbErr>
     where
         C: ConnectionTrait,