add changelog & before_create docs

Author: snopoke

docs/changelog.md

@@ -0,0 +1,17 @@
+---
+hide:
+  - navigation    
+---
+
+# Changelog
+
+## v1.5.0
+
+**2025-02-14**
+
+* **NEW** Tasks now support tagging. Tags are useful for categorizing tasks and filtering them in the UI. See [Task Tags](data_model.md#tags) for more information.
+
+**Python SDK**
+
+* **NEW** Support for tagging.
+* **NEW** `before_create` callback to allow modification of task data before it is created. This is useful for adding global tags and metadata to tasks such as the current tenant etc. See [Before Create Callback](python.md#before-create-callback) for more information.

docs/python.md

@@ -25,7 +25,16 @@ taskbadger.init(
 )
 ```
 
-Details about these configuration parameters can be found [here](basics.md#organization-and-project)
+Details about the slug configuration parameters can be found [here](basics.md#organization-and-project).
+
+| Name              | Description                                                                                               |
+|-------------------|-----------------------------------------------------------------------------------------------------------|
+| organization_slug | The organization identifier.                                                                              |
+| project_slug      | The project identifier.                                                                                   |
+| token             | API authentication token.                                                                                 |
+| tags              | Global tags which are added to all tasks.                                                                 |
+| systems           | System integrations such as [Celery](python-celery.md)                                                    |
+| before_create     | A function that is called before a task is created. See [Before Create Callback](#before-create-callback) |
 
 If you attempt to use the SDK without configuring it you will get an error. To avoid this you can use the
 [safe functions](#safe-functions) which will log any errors to the `taskbadger` logger.
@@ -120,6 +129,20 @@ def taskbadger_scope_middleware(get_response):
     key is present in the current scope as well as the data passed in directly, the value in the data passed
     directly will be used. The same applies to tags.
 
+## Before Create Callback
+
+The `before_create` parameter in the `taskbadger.init` function allows you to define a function that will be called before a task is created. This function will be passed the task data as a dictionary and should return the modified task data.
+
+```python
+def before_create(task_data: dict) -> dict:
+    data = task_data.setdefault("data", {})
+    data["custom"] = "data"
+    
+    tags = task_data.setdefault("tags", {})
+    tags["tenant"] = "acme"
+    
+    return task_data
+```
 
 ## Python Reference
 

mkdocs.yml

@@ -84,6 +84,8 @@ nav:
     - 'Basic Usage': 'python.md'
     - 'Function Decorator': 'python-decorator.md'
     - 'Celery Integration': 'python-celery.md'
+  - 'Changelog':
+    - 'changelog.md'
 
 plugins:
 - mkdocstrings: