From aa818738c29086125826c7d6ed437925031b4078 Mon Sep 17 00:00:00 2001
From: Andre Medeiros <me@andremedeiros.info>
Date: Wed, 11 Jul 2018 14:53:08 -0400
Subject: [PATCH] Augment README

---
 README.md | 45 +++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 41 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 5d4fd2f..4ce7b59 100644
--- a/README.md
+++ b/README.md
@@ -9,10 +9,37 @@ An exception to this is the NodeJS version, which needs to be updated in the `FR
 
 ## Building
 
-Building requires Docker to be installed on your local machine. To build, run:
+Building requires Docker to be installed on your local machine. 
+
+### Scripted
+
+If you have Ruby installed in your system, run:
 
 ```
-$ script/build
+$ ruby script/build
+```
+
+To release, add `--release` as a parameter of the build script.
+
+### Manually
+
+Building and releasing manually isn't too hard either, but there are a couple steps.
+
+#### Tags
+
+To facilitate the images being found, we tag them with the following rules (as an example, the `3.1.5` version will be used.)
+
+- Tag with `statusim/embark:latest` if `3.1.5` is the latest version.
+- Tag with `statusim/embark:3.1.5`
+- Tag with `statusim/embark:3.1` if `3.1.5` is the highest patch level on `3.1`
+- Tag with `statism/embark:3` if `3.1.5` is the highest minor and patch level on `3`
+
+#### Generating the image
+
+To generate the image, run:
+
+```
+docker build . -t statusim/embark:<version> [...tags]
 ```
 
 ## Releasing
@@ -23,8 +50,18 @@ Releasing requires that you're authenticated to Docker Hub. To do so, run:
 $ docker login
 ```
 
-After, or if you're already authenticated, run:
+### Scripted
+
+If you have Ruby installed in your system, run:
 
 ```
-$ script/build --release
+$ ruby script/build --release
+```
+
+### Manual
+
+Pushing the tags manually implies that the image has been previously built. To push your local images, run:
+
+```
+docker push statusim/embark:version
 ```