From 01ebffb0d8316c1e3cc25c69c0b4ff0b26453fb1 Mon Sep 17 00:00:00 2001
From: Peter Bourgon <peter@bourgon.org>
Date: Wed, 13 May 2015 17:00:09 +0100
Subject: [PATCH] README: update with build and run instructions

---
 README.md | 33 +++++++++++++++++++++++++++++----
 1 file changed, 29 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 901c0c84c..0864a077b 100644
--- a/README.md
+++ b/README.md
@@ -2,13 +2,18 @@
 
 ## Overview
 
-TODO
+Weave Scope automatically generates a map of your containers, enabling you to
+intuitively understand, monitor, and control your applications.
 
-## Developing
+Please note that the code, and especially the building and running story, is in
+a **pre-alpha** state. Please take a look, but don't be surprised if you hit
+bugs or missing pieces.
 
-### Building
+## Building
 
-To build everything in-place,
+### In-place
+
+To build the binaries in-place,
 
 ```
 make build
@@ -30,3 +35,23 @@ Or, as a shortcut,
 make dist
 ```
 
+### Docker container
+
+To build a Docker container,
+
+```
+make docker
+```
+
+## Running
+
+### Manually
+
+1. Launch a probe process on each physical host you intend to monitor, via `sudo probe`
+2. Launch an app process, and configure it to talk to probes, via `app -probes="probe-host-1:4030,probe-host-2:4030"`.
+3. Load the user interface, via **http://app-host:4040**
+
+### As a Docker container
+
+TODO
+