add README to scenarios

example-1-sidecars/README.md

@@ -0,0 +1,15 @@
+# Spin using Sidecars on Kubernetes
+
+## Scenario
+
+This scenario will demonstrate deployment and configuration a Spin application sharing an ephemeral volume with a content providing container.
+
+The sidecar container will continuously pull a git repository which contains an `index.html` that will be served by the Spin application.
+
+[insert image here]
+
+## Known-Issues
+
+At this point in time the spin-static-file server performs a local copy of the served directory. As a consequence the server will not be able to detect or serve updated files.
+
+This behavior can be circumvented by using the `--direct-mounts` flag of `spin up` command. Unfortunately this is not yet possible using [containerd-shim-spin-v1](https://github.com/deislabs/containerd-wasm-shims/tree/main/containerd-shim-spin-v1).

example-2-redis/README.md

@@ -0,0 +1,11 @@
+# Spin using Redis on Kubernetes
+
+## Scenario
+
+This scenario will demonstrate deployment and configuration a Spin application connecting to a Redis database.
+
+## Known-Issues
+
+At this point in time it is not possible to handover a `runtime_config.toml` to [containerd-shim-spin-v1](https://github.com/deislabs/containerd-wasm-shims/tree/main/containerd-shim-spin-v1). This means that the Spin application will not honor the `RUNTIME_CONFIG_FILE` environment variable and always use a local KV instead.
+
+Therefore this scenario is not yet fully functional.