diff --git a/README.md b/README.md
index 81e3532..1088697 100644
--- a/README.md
+++ b/README.md
@@ -25,6 +25,10 @@ Uninstall
 opam remove zmq
 ```
 
+Documentation
+-------------
+API documentation can be found [here](https://issuu.github.io/ocaml-zmq)
+
 Development
 -----------
 
diff --git a/zmq-lwt.descr b/zmq-lwt.descr
index 43bc5e3..d548eb1 100644
--- a/zmq-lwt.descr
+++ b/zmq-lwt.descr
@@ -1 +1 @@
-Lwt aware bindings to zmq
\ No newline at end of file
+Lwt aware bindings to zmq
diff --git a/zmq.descr b/zmq.descr
index 4f5ceb9..a85bf90 100644
--- a/zmq.descr
+++ b/zmq.descr
@@ -1 +1,7 @@
-OCaml bindings for ZeroMQ 4.x
\ No newline at end of file
+OCaml bindings for ZeroMQ 4.x
+
+This library contains basic bindings for zmq.
+Lwt aware bindings to zmq is availble though package zmq-lwt
+Async aware bindings to zmq is availble though package zmq-async
+
+Api documentation can be found at https://issuu.github.io/ocaml-zmq