docs: Improve docs

Author: EnriqueSoria

docs/advanced.md

@@ -24,16 +24,27 @@ class UserAccount(LifecycleModel):
 
     @hook(AFTER_UPDATE)
     def on_name_change_heck_on_marital_status(self):
-        if self.has_changed('last_name') and not self.has_changed('marital_status'):
-            send_mail(to=self.email, "Has your marital status changed recently?")
+        if (
+            self.has_changed('last_name') 
+            and not self.has_changed('marital_status')
+        ):
+            send_mail(
+                to=self.email, 
+                "Has your marital status changed recently?"
+            )
 
 ```
 
 ## Custom conditions <a id="custom-conditions"></a>
 Custom conditions can be created as long as they respect condition signature
 ```python
-def changes_to_ned_flanders(instance, update_fields=None):
-    ...
+def changes_to_ned_flanders(instance, update_fields=None) -> bool:
+    return (
+        instance.has_changed("first_name") 
+        and instance.has_changed("last_name")
+        and instance.first_name == "Ned"
+        and instance.last_name == "Flanders"
+    )
 ```
 
 To allow your custom conditions to be chainable, create a class based condition inheriting `ChainableCondition`.
@@ -45,12 +56,19 @@ from django_lifecycle.conditions.base import ChainableCondition
 
 class IsNedFlanders(ChainableCondition):
     def __call__(self, instance, update_fields=None):
-        return instance.first_name == "Ned" and instance.last_name == "Flanders"
+        return (
+            instance.first_name == "Ned" 
+            and instance.last_name == "Flanders"
+        )
 
 
 @hook(
     BEFORE_SAVE,
-    condition=WhenFieldHasChanged("first_name") & WhenFieldHasChanged("last_name") & IsNedFlanders()
+    condition=(
+        WhenFieldHasChanged("first_name")
+        & WhenFieldHasChanged("last_name")
+        & IsNedFlanders()
+    )
 )
 def foo():
     ...

docs/index.md

@@ -20,7 +20,10 @@ class Article(LifecycleModel):
     status = models.ChoiceField(choices=['draft', 'published'])
     editor = models.ForeignKey(AuthUser)
 
-    @hook(BEFORE_UPDATE, condition=WhenFieldHasChanged('contents', has_changed=True))
+    @hook(
+        BEFORE_UPDATE, 
+        condition=WhenFieldHasChanged('contents', has_changed=True),
+    )
     def on_content_change(self):
         self.updated_at = timezone.now()