Make fan-out example local runnable

docs/cli.md

@@ -74,6 +74,12 @@ Publish the local HTML example:
 go run ./cmd/distributor run --config examples/local-html.yml
 ```
 
+Preview local fan-out publication:
+
+```sh
+go run ./cmd/distributor run --config examples/fan-out.yml --dry-run
+```
+
 ## Output
 
 `run` prints the number of configured pipelines, one line per pipeline, one line per planned destination action, and a final status line. Actions include:

docs/config.md

@@ -150,5 +150,4 @@ Maintained examples live under [examples](../examples/):
 - `local-to-local.yml`: minimal local config.
 - `local-publish.yml`: runnable local source publication.
 - `local-html.yml`: runnable local HTML publication.
-
+- `fan-out.yml`: runnable local fan-out publication to source and HTML destinations.
-`examples/fan-out.yml` currently demonstrates accepted SSH/S3 config shape but is not executable until remote backend support exists.

docs/operations.md

@@ -26,6 +26,12 @@ Run the local HTML publication:
 go run ./cmd/distributor run --config examples/local-html.yml
 ```
 
+Preview local fan-out publication:
+
+```sh
+go run ./cmd/distributor run --config examples/fan-out.yml --dry-run
+```
+
 ## Filesystem Layout
 
 Source bundles are discovered beneath the configured local source root. Each bundle is a directory containing `manifest.json`.

examples/fan-out.yml

@@ -1,28 +1,18 @@
 pipelines:
-  - id: reports
+  - id: example-fan-out
     source:
       backend: local
-      path: /var/spool/distributor/reports
+      path: examples/source-bundle
-    validation:
-      on_digest_mismatch: fail
     destinations:
-      - id: markdown-archive
+      - id: local-source-archive
-        backend: s3
+        backend: local
-        endpoint: https://s3.example.com
+        path: workspace/published/fan-out/source
-        bucket: reports
-        prefix: archive
-        region: us-east-1
-        force_path_style: true
-        credentials:
-          access_key_id_env: DISTRIBUTOR_S3_ACCESS_KEY_ID
-          secret_access_key_env: DISTRIBUTOR_S3_SECRET_ACCESS_KEY
         publish:
           source: true
           html: false
-      - id: static-site
+      - id: local-html-site
-        backend: ssh
+        backend: local
-        uri: ssh://deploy@example.com:22
+        path: workspace/published/fan-out/html
-        path: /srv/www/reports
         publish:
           source: false
           html: true