Adds development instructions

.editorconfig

@@ -6,3 +6,7 @@ insert_final_newline = true
 charset = utf-8
 indent_style = space
 indent_size = 2
+
+[Makefile]
+indent_style = tab
+indent_size = 4

Makefile

@@ -0,0 +1,5 @@
+installLocalDependencies:
+	mvn install:install-file -Dfile=./umlet/lib/umlet-mini-14.3.0.jar -DgroupId=com.umlet -DartifactId=umlet-mini -Dversion=14.3.0 -Dpackaging=jar
+	mvn install:install-file -Dfile=./server/lib/ditaa-1.3.13.jar -DgroupId=ditaa -DartifactId=ditaa -Dversion=1.3.13 -Dpackaging=jar
+	mvn install:install-file -Dfile=./server/lib/ditaamini-0.11.jar -DgroupId=ditaa -DartifactId=ditaa-mini -Dversion=0.11 -Dpackaging=jar
+

README.adoc

@@ -1,7 +1,55 @@
 = Kroki
+:uri-maven: https://maven.apache.org/
 
-== Requirements
+Kroki provides a unified API with support for BlockDiag (BlockDiag, SeqDiag, ActDiag, NwDiag), C4 (with PlantUML), Ditaa, Erd, GraphViz, PlantUML, SvgBob and UMLet... and more to come!
 
- $ mvn install:install-file -Dfile=./umlet/lib/umlet-mini-14.3.0.jar -DgroupId=com.umlet -DartifactId=umlet-mini -Dversion=14.3.0 -Dpackaging=jar
- $ mvn install:install-file -Dfile=./server/lib/ditaa-1.3.13.jar -DgroupId=ditaa -DartifactId=ditaa -Dversion=1.3.13 -Dpackaging=jar
- $ mvn install:install-file -Dfile=./server/lib/ditaamini-0.11.jar -DgroupId=ditaa -DartifactId=ditaa-mini -Dversion=0.11 -Dpackaging=jar
+== Usage
+
+Kroki uses a simple algorithm (deflate + base64) to encode your diagram in the URL:
+
+`GET /plantuml/png/SyfFKj2rKt3CoKnELR1Io4ZDoSa70000`
+
+You can also call Kroki with `POST`:
+
+`POST /`
+
+```json
+{
+  "diagram_source": "Bob -> Alice : hello",
+  "diagram_type": "plantuml",
+  "output_format": "png"
+}
+```
+
+In this case, you don't need to encode your diagram.
+
+== Development
+
+Kroki server is built using {uri-maven}[Maven].
+
+=== Project layout
+
+Kroki has a modular architecture.
+
+core::
+A Java web server (powered by Vert.x) that acts as a gateway.
+
+umlet::
+A tiny Java API on top of UMlet (mini) to generate diagrams.
+
+nomnoml::
+fds
+
+=== Build core
+
+The first step is to install the local dependencies in your local repository using `make`:
+
+ $ make installLocalDependencies
+
+Then you can build the project using `mvn`:
+
+ $ mvn clean package
+
+=== Create a Docker image
+
+Kroki has a modular architecture.

docker-compose.yml

@@ -1,12 +1,12 @@
 version: "3"
 services:
-  base:
-    image: kroki/kroki-base
+  core:
+    image: yuzutech/kroki
     environment:
       - KROKI_BLOCKDIAG_HOST=blockdiag
     ports:
       - "8000:8000"
   blockdiag:
-    image: kroki/kroki-blockdiag
+    image: yuzutech/kroki-blockdiag
     ports:
       - "8001:8001"