diff --git a/src/cljs/sixsq/slipstream/webui/docs/views.cljs b/src/cljs/sixsq/slipstream/webui/docs/views.cljs
index 24532046..a3cb50f7 100644
--- a/src/cljs/sixsq/slipstream/webui/docs/views.cljs
+++ b/src/cljs/sixsq/slipstream/webui/docs/views.cljs
@@ -22,6 +22,14 @@
                           :overflow      "hidden"
                           :text-overflow "ellipsis"}} (:description entry)]])
 
+(defn documents-intro
+  []
+  (let [tr (subscribe [::i18n-subs/tr])]
+    (fn []
+      [:div [ui/Message {:info true}
+             [ui/Icon {:name "info"}]
+             (@tr [:documentation-intro])]])))
+
 
 (defn documents-table
   []
@@ -51,6 +59,7 @@
 (defn documents-view
   []
   [ui/Container {:fluid true}
+   [documents-intro]
    [documents-table]])
 
 
diff --git a/src/cljs/sixsq/slipstream/webui/i18n/dictionary.cljs b/src/cljs/sixsq/slipstream/webui/i18n/dictionary.cljs
index 3e3c805a..57f95c0f 100644
--- a/src/cljs/sixsq/slipstream/webui/i18n/dictionary.cljs
+++ b/src/cljs/sixsq/slipstream/webui/i18n/dictionary.cljs
@@ -49,7 +49,8 @@
         :describe                 "describe"
         :description              "description"
         :details                  "details"
-        :documentation            "documentation"
+        :documentation            "api documentation"
+        :documentation-intro      "Welcome to the API documentation. It has been designed to be comprehensive, covering all resources, and portable, allowing access from any programming language."
         :download                 "download"
         :drop-file                "drop file"
         :edit                     "edit"
@@ -218,7 +219,8 @@
         :describe               "décrire"
         :description            "description"
         :details                "détails"
-        :documentation          "documentation"
+        :documentation          "api documentation"
+        :documentation-intro     "Bienvenue sur la documentation de l'API. Elle a été conçue pour etre lisible, exhaustive, et portable, accessible depuis n'importe quel langage de programmation."
         :download               "télécharger"
         :drop-file              "déposer un fichier"
         :edit                   "modifier"