turbo_refreshes_with docs

docs/source/template-tags.md

@@ -2,6 +2,28 @@
 
 Generate `turbo-frame` and `turbo-stream` from Django template is now the **recommended** way since it is more clean and easy to understand.
 
+## turbo_refreshes_with
+
+This template tag generates HTML meta tags for Turbo Drive to control the refresh method and scroll behavior in Turbo 8.0+ ([currently in beta](https://github.com/hotwired/turbo/releases/tag/v8.0.0-beta1)).
+
+### Parameters
+
+- `method` (optional, default: `'replace'`): Specifies the refresh method. Must be one of `'replace'` or `'morph'`.
+- `scroll` (optional, default: `'reset'`): Specifies the scroll behavior. Must be one of `'reset'` or `'preserve'`.
+
+### Behavior
+
+This tag creates HTML meta tags defining the Turbo Frames' refresh method and scroll behavior based on the provided parameters. If the provided parameters are not within the valid options, a `ValidationError` is raised.
+
+### Example Usage
+
+```django
+{% load custom_tags %}
+
+<!-- Generate Turbo Frames refresh meta tags -->
+{% turbo_refreshes_with method='replace' scroll='reset' %}
+```
+
 ## dom_id
 
 `dom_id` is a helper method that returns a unique DOM ID based on the object's class name and ID