Update deployment and readme

1 files changed, 24 insertions, 7 deletions

diff --git a/README.md b/README.md
index d816262..c4a3d5c 100644
--- a/README.md
+++ b/README.md
@@ -3,33 +3,50 @@
 A simple golang application to explore [liveness and readiness checks][1] in
 Kubernetes.
 
+## Explanation
+
+The `showreadiness` program will respond to requests on port 80 locally, port
+6080 externally, with text indicating it is handling traffic. With that
+response, there is a header called `responding-pod` which contains the name of
+the pod (its hostname).
+
+Calling `/makeNotReady` will disable traffic processing for whichever host
+handled the request. Using this endpoint, we can stop traffic to each pod, and
+then restore it using the `/makeReady` endpoint directly (via accessing the pod
+over `localhost`).
+
 ## To build
 
 In the cloned directory, run the following:
 
-Linux/OSX:
+### Linux/OSX
 
 ```bash
 CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -a -tags netgo -installsuffix netgo -ldflags '-w -s' .
 ```
 
-Windows:
+### Windows
 
 ```powershell
-$env:CGO_ENABLED=0; $env:GOOS="linux"; $env:GOARCH="amd64"; go build -a -tags netgo -installsuffix netgo -ldflags "-s"
+$env:CGO_ENABLED=0; $env:GOOS="linux"; $env:GOARCH="amd64";
+go build -a -tags netgo -installsuffix netgo -ldflags "-s"
 ```
 
-Or type your
+Don't forget to unset the variables when you're done!
 
-## To build with only Docker
+```powershell
+Remove-Item env:CGO_ENABLED; Remove-Item env:GOOS; Remove-Item env:GOARCH;
+```
+
+### Using only Docker (no Go compiler)
 
-If [docker][2] is installed, run the folowing in the checked-out directory:
+Assuming [docker][2] is installed, run the folowing in the checked-out directory:
 
 ```bash
 docker run --rm -v $PWD:/go/src/github.com/tydavis/showreadiness \
 -w /go/src/github.com/tydavis/showreadiness golang:alpine /bin/sh \
 -c "CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -a -tags netgo -installsuffix netgo -ldflags '-w -s' . "
-```
+``` 
 
 [1]:http://kubernetes.io/docs/user-guide/pod-states/
 [2]:https://www.docker.com/get-docker
\ No newline at end of file