Document shared-root publishing

examples/shared-root.yml

@@ -0,0 +1,31 @@
+pipelines:
+  - id: example-shared-root-source
+    source:
+      backend: local
+      path: examples/source-bundle
+    destinations:
+      - id: shared-local-root
+        backend: local
+        path: workspace/published/shared-root
+        state:
+          mode: shared_root
+        publish:
+          source: true
+          html: false
+  - id: example-shared-root-html
+    source:
+      backend: local
+      path: examples/source-bundle
+    destinations:
+      - id: shared-local-root
+        backend: local
+        path: workspace/published/shared-root
+        state:
+          mode: shared_root
+        publish:
+          source: false
+          html: true
+        transform:
+          markdown_to_html:
+            enabled: true
+            mode: sidecar