From 9241b8abf7f0f015b3d741c2521ca4ad196b6689 Mon Sep 17 00:00:00 2001
From: Nicolas Dextraze <nicolas.dextraze@dexdo.com>
Date: Sat, 25 Jun 2016 00:14:20 -0700
Subject: [PATCH] Update README

---
 README    | 23 -----------------------
 README.md | 39 +++++++++++++++++++++++++++++++++++++++
 2 files changed, 39 insertions(+), 23 deletions(-)
 delete mode 100644 README
 create mode 100644 README.md

diff --git a/README b/README
deleted file mode 100644
index 1ed00dc..0000000
--- a/README
+++ /dev/null
@@ -1,23 +0,0 @@
-GoLang implementation of a simple EventStore
-
--------
-LICENSE
--------
-
-see LICENSE file.
-
----------------
-GETTING STARTED
----------------
-
-You can run a simple GOES server with this command:
-
-go run simpleserver/simpleserver.go --db=./events --addr=tcp://127.0.0.1:12345
-
-Both flags are optional and their default values are the same as the example.
-
------
-Notes
------
-
-- On Windows, zmq4 requires Administrative privileges to bind the socket (not sure why, probably related to integrated encryption features in zmq4)
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..413d442
--- /dev/null
+++ b/README.md
@@ -0,0 +1,39 @@
+GoLang implementation of a simple EventStore
+
+# Getting started
+
+## Pre-requisites
+
+- Install [GoLang](https://golang.org/doc/install) version 1.6+
+- Install [libsodium](https://download.libsodium.org/libsodium/releases/)\* version 1.0.10+ (Linux only^)
+- Install [zeromq](http://zeromq.org/intro:get-the-software)\* version 4.0+ (Linux only^)
+- Install [msys2](https://msys2.github.io/) (Windows only)
+
+\* On Linux libsodium and zeromq are installed from source (`./configure && make && sudo make install && sudo ldconfig`)  
+^ On Window libzmq and libsodium are installed using pacman in MSYS2 shell (`pacman -S mingw-w64-x86_64-zeromq`)
+
+## Build
+
+### Fetching GO packages
+
+In your GOPATH folder, execute the following commands:
+
+  `go get github.com/adymitruk/goes`  
+  `go get github.com/pebbe/zmq4`  
+  `go get github.com/satori/go.uuid`  
+  
+### Compiling the binary
+
+In your GOPATH folder, execute the following command:
+
+  `go build -o bin/goes src/github.com/adymitruk/goes/simpleserver/simpleserver.go`
+  
+\* Use `-o bin/goes.exe` on Windows
+
+## Running the server
+
+In your GOPATH folder, execute the following command:
+
+  `./bin/goes --db=./events --addr=tcp://127.0.0.1:12345`
+
+Both flags are optional and their default values are the same as the example.