update documentation

docs/examples.md

@@ -28,6 +28,14 @@ Or you want to email a user when their account is deleted. You could add the dec
         )
 ```
 
+Or if you want to enqueue a background job that depends on state being committed to your database
+
+```python
+    @hook(AFTER_CREATE, on_commit=True)
+    def do_after_create_jobs(self):
+        enqueue_job(send_item_shipped_notication, self.item_id)
+```
+
 Read on to see how to only fire the hooked method if certain conditions about the model's current and previous state are met.
 
 ## Transitions between specific values

docs/hooks_and_conditions.md

@@ -17,6 +17,7 @@ You can hook into one or more lifecycle moments by adding the `@hook` decorator
         was: Any = '*', 
         was_not: Any = None,
         changes_to: Any = None,
+        on_commit: Optional[bool] = None
     ):
 ```
 ## Lifecycle Moments
@@ -52,3 +53,4 @@ If you do not use any conditional parameters, the hook will fire every time the
 | was | Any | Only fire the hooked method if the value of the `when` field was equal to this value when first initialized; defaults to `*`.  |
 | was_not | Any | Only fire the hooked method if the value of the `when` field was NOT equal to this value when first initialized. |
 | changes_to | Any | Only fire the hooked method if the value of the `when` field was NOT equal to this value when first initialized but is currently equal to this value. |
+| on_commit | bool | When `True` only fire the hooked method after the current database transaction has been commited or not at all. (Only applies to `AFTER_*` hooks)  |