1 files changed, 36 insertions, 0 deletions
diff --git a/README.md b/README.md
index a41d042..bbe4192 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,39 @@
 # Storehouse: Object storage HTTP server
 
+Storehouse is a simple HTTP service to store text objects organized by buckets,
+written in Go.
 
+The service has two backends: one stores the objects in-memory, the other uses
+files for persistence.
+
+The in-memory backend features a proactive de-duplication mechanism that avoids
+the creation of objects with duplicate content inside the same bucket.
+
+## Building Storehouse
+
+Simply run `make` or `go build` in the root directory.
+
+## Usage
+
+The options are displayed with -h/--help:
+
+```
+$ ./storehouse -h
+Usage of ./storehouse:
+  -datadir string
+        The directory where the objects are stored with the file backend (default "data")
+  -memory
+        Memory backend with de-duplication (default: file backend w/o de-dup)
+  -port int
+        The port on which the server will listen for connections (default 8080)
+```
+
+## Potential improvements
+
+* More and better tests, including integration and e2e tests.
+
+* Implementation of the de-duplication mechanism for the file backend.
+
+* Better logging, using a log package instead of printf.
+
+* ...