diff --git a/bi_view_editor/README.rst b/bi_view_editor/README.rst
index 66c2afbc..0b3e6ff7 100644
--- a/bi_view_editor/README.rst
+++ b/bi_view_editor/README.rst
@@ -44,7 +44,7 @@ To graphically design your analysis data-set:
 Known issues / Roadmap
 ======================
 
-* Non-stored fields are not supported
+* Non-stored fields and many2many fields are not supported
 * Provide graph view for table relations
 * Extend the capabilities of the tree views (e.g. add sums)
 * Provide a tutorial (eg. a working example of usage)
diff --git a/bi_view_editor/readme/CONTRIBUTORS.rst b/bi_view_editor/readme/CONTRIBUTORS.rst
new file mode 100644
index 00000000..14cc58d6
--- /dev/null
+++ b/bi_view_editor/readme/CONTRIBUTORS.rst
@@ -0,0 +1,8 @@
+* Simon Janssens <s.janssens@onestein.nl>
+* Diego Luis Neto <diegoluis.neto@gmail.com>
+* Dennis Sluijk <d.sluijk@onestein.nl>
+* Kevin Graveman <k.graveman@onestein.nl>
+* Richard Dijkstra <r.dijkstra@onestein.nl>
+* Andrea Stirpe <a.stirpe@onestein.nl>
+* Antonio Esposito <a.esposito@onestein.nl>
+* Jordi Ballester Alomar <jordi.ballester@eficent.com>
diff --git a/bi_view_editor/readme/DESCRIPTION.rst b/bi_view_editor/readme/DESCRIPTION.rst
new file mode 100644
index 00000000..f3f712b0
--- /dev/null
+++ b/bi_view_editor/readme/DESCRIPTION.rst
@@ -0,0 +1,14 @@
+BI View Editor is a tool integrated in Odoo that allows users define and
+execute their own reports without the need to code.
+
+Purpose:
+
+* The BI View Editor is used to create reports not already contained in the
+  standard Odoo, combining data from existing sources.
+
+* It has been designed to be used by users with little or no knowledge of
+  the technical architecture of Odoo. Users visually link business objects
+  and select the fields to visualize.
+
+* The BI View Editor offers users different types of representations,
+  including tree, graph, pivot views.
diff --git a/bi_view_editor/readme/ROADMAP.rst b/bi_view_editor/readme/ROADMAP.rst
new file mode 100644
index 00000000..66f5cb90
--- /dev/null
+++ b/bi_view_editor/readme/ROADMAP.rst
@@ -0,0 +1,5 @@
+* Non-stored fields and many2many fields are not supported
+* Provide graph view for table relations
+* Extend the capabilities of the tree views (e.g. add sums)
+* Provide a tutorial (eg. a working example of usage)
+* Implement a more advanced UI, with possibilities to use LEFT JOIN as default instead of INNER JOIN
diff --git a/bi_view_editor/readme/USAGE.rst b/bi_view_editor/readme/USAGE.rst
new file mode 100644
index 00000000..a91ccbdd
--- /dev/null
+++ b/bi_view_editor/readme/USAGE.rst
@@ -0,0 +1,10 @@
+To graphically design your analysis data-set:
+
+- From the Dashboards menu, select "Custom BI Views"
+- Browse trough the business objects in the Query tab
+- Pick the interesting fields (Drag & Drop)
+- For each selected field, right-click on the Options column and select whether it's a row, column or measure; if you want to remove the field from the list view, unflag the checkbox ´List´ in the Options column
+- Save and click "Generate BI View"
+- Click "Open BI View" to view the result
+- If module Dashboard (board) is installed, the standard "Add to My Dashboard" functionality would be available
+- Click "Create a menu" to create a new menu item directly linked to your new BI view (this feature is available in developer mode); when the BI view is reset back to draft this menu will be removed, and you will need to re-create the menu entry.