diff --git a/examples/k8s/README.md b/examples/k8s/README.md
new file mode 100644
index 0000000..c123f03
--- /dev/null
+++ b/examples/k8s/README.md
@@ -0,0 +1,27 @@
+# Wiki Farm in Kubernetes
+
+There are easier ways to get started with federated wiki. Here we are
+using wiki to drive some learning about kubernetes.
+
+# We're using MacOS, Docker Desktop, and kind
+
+    brew cask install docker
+    brew install kind
+    kind create cluster --name wiki
+
+# Deploy Wiki
+
+    kubectl apply -f wiki.yaml
+
+# Play with the wiki
+
+    # pbcopy & open are MacOS commands
+    kubectl port-forward svc/wiki-service 3000:80 \
+      > port-forward.log \
+      2> port-forward.err &
+    # get admin password on the clipboard
+    kubectl exec svc/wiki-service -- \
+      jq -r .admin .wiki/config.json \
+      | pbcopy
+    open http://localhost:3000
+    # login with the password on the clipboard