quick draft of offline docs

Archmonger · Archmonger · commit 29be8e4746c8 · 2024-01-18T20:57:02.000-08:00
diff --git a/README.md b/README.md
@@ -25,6 +25,7 @@
 -   [Distributed computing](https://reactive-python.github.io/reactpy-django/latest/reference/settings/#reactpy_default_hosts)
 -   [Performance enhancements](https://reactive-python.github.io/reactpy-django/latest/reference/settings/#performance-settings)
 -   [Customizable reconnection behavior](https://reactive-python.github.io/reactpy-django/latest/reference/settings/#stability-settings)
+-   [Customizable disconnection behavior](https://reactive-python.github.io/reactpy-django/latest/reference/template-tag)
 -   [Multiple root components](https://reactive-python.github.io/reactpy-django/latest/reference/template-tag/)
 -   [Django view to ReactPy component conversion](https://reactive-python.github.io/reactpy-django/latest/reference/components/#view-to-component)
 -   [Django static file access](https://reactive-python.github.io/reactpy-django/latest/reference/components/#django-css)
diff --git a/docs/src/reference/template-tag.md b/docs/src/reference/template-tag.md
@@ -28,6 +28,7 @@ This template tag can be used to insert any number of ReactPy components onto yo
     | `#!python key` | `#!python Any` | Force the component's root node to use a [specific key value](https://reactpy.dev/docs/guides/creating-interfaces/rendering-data/index.html#organizing-items-with-keys). Using `#!python key` within a template tag is effectively useless. | `#!python None` |
     | `#!python host` | `#!python str | None` | The host to use for the ReactPy connections. If unset, the host will be automatically configured.<br/>Example values include: `localhost:8000`, `example.com`, `example.com/subdir` | `#!python None` |
     | `#!python prerender` | `#!python str` | If `#!python "True"`, the component will pre-rendered, which enables SEO compatibility and reduces perceived latency. | `#!python "False"` |
+    | `#!python offline` | `#!python str` | The dotted path to a component that will be displayed if your root component loses connection to the server. Keep in mind, this `offline` component will be non-interactive (hooks won't operate). | `#!python ""` |
     | `#!python **kwargs` | `#!python Any` | The keyword arguments to provide to the component. | N/A |
 
     <font size="4">**Returns**</font>
@@ -66,26 +67,6 @@ This template tag can be used to insert any number of ReactPy components onto yo
 
 <!--context-end-->
 
-??? question "Can I render components on a different server (distributed computing)?"
-
-    Yes! This is most commonly done through [`settings.py:REACTPY_HOSTS`](../reference/settings.md#reactpy_default_hosts). However, you can use the `#!python host` keyword to render components on a specific ASGI server.
-
-    === "my-template.html"
-
-        ```jinja
-        ...
-        {% component "example_project.my_app.components.do_something" host="127.0.0.1:8001" %}
-        ...
-        ```
-
-    This configuration most commonly involves you deploying multiple instances of your project. But, you can also create dedicated Django project(s) that only render specific ReactPy components if you wish.
-
-    Here's a couple of things to keep in mind:
-
-    1. If your host address are completely separate ( `origin1.com != origin2.com` ) you will need to [configure CORS headers](https://pypi.org/project/django-cors-headers/) on your main application during deployment.
-    2. You will not need to register ReactPy WebSocket or HTTP paths on any applications that do not perform any component rendering.
-    3. Your component will only be able to access your template tag's `#!python *args`/`#!python **kwargs` if your applications share a common database.
-
 <!--multiple-components-start-->
 
 ??? question "Can I use multiple components on one page?"
@@ -111,7 +92,6 @@ This template tag can be used to insert any number of ReactPy components onto yo
     Additionally, in scenarios where you are trying to create a Single Page Application (SPA) within Django, you will only have one component within your `#!html <body>` tag.
 
 <!--multiple-components-end-->
-<!--args-kwargs-start-->
 
 ??? question "Can I use positional arguments instead of keyword arguments?"
 
@@ -129,4 +109,30 @@ This template tag can be used to insert any number of ReactPy components onto yo
         {% include "../../python/template-tag-args-kwargs.py" %}
         ```
 
-<!--args-kwargs-end-->
+??? question "Can I render components on a different server (distributed computing)?"
+
+    Yes! This is most commonly done through [`settings.py:REACTPY_HOSTS`](../reference/settings.md#reactpy_default_hosts). However, you can use the `#!python host` keyword to render components on a specific ASGI server.
+
+    === "my-template.html"
+
+        ```jinja
+        ...
+        {% component "example_project.my_app.components.do_something" host="127.0.0.1:8001" %}
+        ...
+        ```
+
+    This configuration most commonly involves you deploying multiple instances of your project. But, you can also create dedicated Django project(s) that only render specific ReactPy components if you wish.
+
+    Here's a couple of things to keep in mind:
+
+    1. If your host address are completely separate ( `origin1.com != origin2.com` ) you will need to [configure CORS headers](https://pypi.org/project/django-cors-headers/) on your main application during deployment.
+    2. You will not need to register ReactPy WebSocket or HTTP paths on any applications that do not perform any component rendering.
+    3. Your component will only be able to access your template tag's `#!python *args`/`#!python **kwargs` if your applications share a common database.
+
+??? question "Can I pre-render components for SEO compatibility?"
+
+    ...
+
+??? question "How do I show something when the client disconnects?"
+
+    ...
