diff --git a/swarm-arm/README.md b/swarm-arm/README.md
index a4b0eca..e32ef97 100644
--- a/swarm-arm/README.md
+++ b/swarm-arm/README.md
@@ -1,5 +1,31 @@
 swarm-arm
 =========
 
+![](https://badge.imagelayers.io/vimagick/swarm-arm:latest.svg)
+
 - https://docs.docker.com/swarm/install-manual/
+- https://docs.docker.com/swarm/discovery/
 - https://github.com/docker/swarm-library-image
+
+```bash
+# on master
+$ docker run --rm vimagick/swarm-arm create
+f9723931d522b39b756bb0b24a7cfc04
+
+# on slave 1
+$ docker run -d --restart always vimagick/swarm-arm join --addr=192.168.1.204:2375 token://f9723931d522b39b756bb0b24a7cfc04
+
+# on slave 2
+$ docker run -d --restart always vimagick/swarm-arm join --addr=192.168.1.204:2375 token://f9723931d522b39b756bb0b24a7cfc04
+
+# on slave 3
+$ docker run -d --restart always vimagick/swarm-arm join --addr=192.168.1.204:2375 token://f9723931d522b39b756bb0b24a7cfc04
+
+# on master
+$ docker run --rm vimagick/swarm-arm list token://f9723931d522b39b756bb0b24a7cfc04
+$ docker run -d --restart always -p 2375:2375 vimagick/swarm-arm manage token://f9723931d522b39b756bb0b24a7cfc04
+$ export DOCKER_HOST=tcp://127.0.0.1:2375
+$ docker info
+```
+
+> Any host can be a master as long as it can reach slaves!
diff --git a/tesseract/README.md b/tesseract/README.md
index 184de50..0c2f66f 100644
--- a/tesseract/README.md
+++ b/tesseract/README.md
@@ -3,7 +3,7 @@ tesseract
 
 ![](https://badge.imagelayers.io/vimagick/tesseract:latest.svg)
 
-`Tesseract` is an Open Source OCR engine, available under the Apache 2.0
+[Tesseract][1] is an Open Source OCR engine, available under the Apache 2.0
 license. It can be used directly, or (for programmers) using an API. It
 supports a wide variety of languages.
 
@@ -18,3 +18,5 @@ $ alias tesseract='docker run --rm -v `pwd`:/work -w /work vimagick/tesseract'
 $ tesseract myscan.png out
 $ cat out.txt
 ```
+
+[1]: https://github.com/tesseract-ocr/tesseract