Add a missing file that should have been in the previous ux push.

docs/ux.md

@@ -0,0 +1,43 @@
+# Kubernetes UX instructions
+
+## Kubernetes User Interface
+Kubernetes currently supports a simple web user interface.
+
+### Running locally
+Start the server:
+
+```sh
+cluster/kubecfg.sh -proxy -www $PWD/www
+```
+
+The UX should now be running on [localhost](http://localhost:8001/static/index.html#/groups//selector)
+
+### Running remotely
+When Kubernetes is deployed, the server deploys the UX, you can visit ```/static/index.html#/groups//selector``` on your master server.
+
+
+### Interacting with the user interface.
+
+The Kubernetes user interface is a query-based visualization of the Kubernetes API.  The user interface is defined by two functional primitives:
+
+#### GroupBy
+_GroupBy_ takes a label ```key``` as a parameter, places all objects with the same value for that key within a single group. For example ```/groups/host/selector``` groups pods by host.  ```/groups/name/selector``` groups pods by name.  Groups are hiearchical, for example ```/groups/name/host/selector``` first groups by pod name, and then by host.
+
+#### Select
+Select takes a [label selector](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/labels.md) and uses it to filter, so only resources which match that label selector are displayed.  For example, ```/groups/host/selector/name=frontend```, shows pods, grouped by host, which have a label with the name `frontend`.
+
+
+## Rebuilding the UX
+The UX relies on [go-bindata](https://github.com/jteeuwen/go-bindata)
+
+To install go-bindata:
+
+```sh
+go get github.com/jteeuwen/go-bindata/...
+```
+
+To rebuild the UX, run the following:
+
+```sh
+go-bindata -o pkg/ui/datafile.go -prefix ${PWD} -pkg ui www/...
+```