Fix the directory structure for documentation in the reference manual.

docs/reference/keypoints.rst

@@ -21,21 +21,30 @@ Documentation
       format  following the Google Python Style Guide (more details in the
       sphinx napoleon_ extension).
 
-      The documentation is generated using sphinx_ generator.
-      The master document is located in the directory
-      ``myapplication/docs``. Its skeleton is created using the command
-      ``sphinx-quickstart``::
+      We recommend to use following directory structure::
 
-        > cd myapplication/docs
+            myapplications/docs
+            myapplications/docs/api
+            myapplications/docs/reference
+            myapplications/docs/user
+
+      The documentation is split in three blocks: the python API, the reference
+      manual for developers and the users manual.
+
+      The documentation is generated using the sphinx_ generator.
+      The first skeleton is obtained via the command
+      ``sphinx-quickstart``, *e.g.*::
+
+        > cd myapplication/docs/api
         > sphinx-quickstart
 
-      Once the documentation written, the ``HTML`` version is obtained by::
+      Once the documentation written, the ``HTML`` version is generated by::
 
-         > cd myapplication
-         > sphinx-build -b html docs static/docs/sphinx
+         > cd myapplication/docs/api
+         > sphinx-build -b html docs static/docs/api
 
       The documentation can be seen from your application, via the URL
-      ``http(s)://mydomain/myapplication/static/docs/sphinx/index.html``
+      ``http(s)://mydomain/myapplication/static/docs/api/index.html``
 
    *Javascript widget documentation*
       Write the documentation of your javascript classes using jsduck_.