diff --git a/README.md b/README.md
index a11aff7..4719cab 100644
--- a/README.md
+++ b/README.md
@@ -136,7 +136,7 @@ kube-proxy | | ✔ |
kubelet | | ✔ |
kubectl (No service file)| | |
-
+
The first three belong on master nodes, kube-proxy and kubelet belong on minions, and kubectl is just an optional handy utility to have on the path.
@@ -154,7 +154,7 @@ So for example, an _upstream provided_ unit file for kube-apiserver exists at `/
At boot Systemd will essentially merge role.conf into the original unit file, and start the kube-apiserver service based on whether or not a file exists at `/etc/sysconfig/kubernetes-masters` (This is called path based activation).
-
+
With this baked into a server image (by a tool like Packer) all that is left is to specify how many copies we want to run and tell cloud-init to create the file. This functionality is **common to basically any modern distro and cloud provider**, and library (like boto) or provisioning tool (like Terraform).
@@ -186,7 +186,7 @@ If you just want to try it out skip to the [Quick start](#quickstart).
Kubernetes components are neatly split up into three distinct groups*.
-
+
Diagram of a highly available kubernetes cluster
@@ -241,7 +241,7 @@ At this point you might be wondering why `minions.{KubernetesCluster}.k8s` is ne
> Kubernetes allocates an IP address to each pod. When creating a cluster, you need to allocate a block of IPs for Kubernetes to use as Pod IPs.
-- [Kubernetes Docs](http://kubernetes.io/docs/getting-started-guides/scratch/#network)
-
+
In order to let Pod A (10.32.0.1) from one minion node (172.20.0.1) communicate with Pod B (10.32.0.3) on another minion node (172.20.0.2) we use an Overlay network. It is possible to achieve this sort of routing without an overlay network (and associated performance penalty) but an overlay is simpler to configure and more importantly it is **_portable_**.
diff --git a/docs/arch.png b/docs/arch.png
new file mode 100644
index 0000000..a0e41ce
Binary files /dev/null and b/docs/arch.png differ
diff --git a/docs/cloud-init.png b/docs/cloud-init.png
new file mode 100644
index 0000000..63de284
Binary files /dev/null and b/docs/cloud-init.png differ
diff --git a/docs/k8s-cube.png b/docs/k8s-cube.png
new file mode 100644
index 0000000..a483e64
Binary files /dev/null and b/docs/k8s-cube.png differ
diff --git a/docs/sdn.png b/docs/sdn.png
new file mode 100644
index 0000000..9c03484
Binary files /dev/null and b/docs/sdn.png differ