feat: formalize platform runtime contracts

docs/fa/docker.md

@@ -1,5 +1,7 @@
 # Docker Usage
 
+Experimental: the container path is not yet a production-grade hidden-service deployment target. Linux with `systemd --user` remains the supported persistent-host environment.
+
 A prebuilt image containing Tor, OnionShare and the `voxvera` CLI is published to
 `ghcr.io/voxvera/voxvera`.
 
@@ -7,10 +9,11 @@ A prebuilt image containing Tor, OnionShare and the `voxvera` CLI is published t
 # pull the image
 docker pull ghcr.io/voxvera/voxvera:latest
 
-# run voxvera quickstart with flyers stored in ./flyers
+# run the experimental container with flyers stored in ./flyers
 mkdir -p flyers
 docker run -it --rm -v "$(pwd)/flyers:/flyers" ghcr.io/voxvera/voxvera
 ```
 
-The container uses `/flyers` as the working directory and runs `voxvera quickstart`
-by default. All generated flyer files will appear in the mounted `flyers` folder.
+The container stores runtime state under `/flyers`, seeds a default `config.json` if needed, and retries `voxvera start-all` periodically after the initial `quickstart`.
+
+Use this path for testing only until the container runtime and background recovery behavior are validated end-to-end.