X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=README.md;h=bcf998191629f9d6919d4a7e4328a15d96ead72d;hb=c5d4383f38e610b997e2565a49da350f63558f88;hp=f7f0c71224074c4b23030b1647949c803c5b6058;hpb=d7778b5fad483cefb93659e670e28264d3664e26;p=apps%2Fagl-service-can-low-level.git

diff --git a/README.md b/README.md
index f7f0c712..bcf99819 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,49 @@
-# CAN signaling binder
+# Low level CAN signaling binder
 
-Low level CAN bus binder. Based upon OpenXC vi-firmware project.
+Low level CAN bus binder, based upon OpenXC vi-firmware project.
 
-# Prerequirements
+Full document can be found under `docs` directory.
 
+# Generate documentation
+
+## Prerequisites
+
+You can use gitbook to serve documentation. To do so, please install it using *npm* as well as *calibre* package from your package distribution manager:
+
+```bash
+sudo npm install -g gitbook-cli
+sudo apt-get install calibre
+```
+
+To generate Doxygen documentation, you'll need doxygen and graphviz:
+
+```bash
+sudo apt-get doxygen graphviz
+```
+
+Prepare your build environment:
+
+```bash
+mkdir build && cd build
+cmake ..
+```
+
+## Generation
+
+Generate a PDF version :
+
+```bash
+make pdf
+```
+
+Serve an HTML version, this will run a web server that will serve you locally documentation :
+
+```bash
+make serve
+```
+
+Generate doxygen documentation:
+
+```bash
+make doxygen
+```
\ No newline at end of file