diff --git a/addons/web/doc/testing.rst b/addons/web/doc/testing.rst
index 2d5876776a3..e870ec091b7 100644
--- a/addons/web/doc/testing.rst
+++ b/addons/web/doc/testing.rst
@@ -497,6 +497,13 @@ Testing API
 
 .. js:function:: openerp.testing.section(name[, options], body)
 
+    A test section, serves as shared namespace for related tests (for
+    constants or values to only set up once). The ``body`` function
+    should contain the tests themselves.
+
+    Note that the order in which tests are run is essentially
+    undefined, do *not* rely on it.
+
     :param String name:
     :param TestOptions options:
     :param body:
@@ -504,6 +511,10 @@ Testing API
 
 .. js:function:: openerp.testing.case(name[, options], callback)
 
+    Registers a test case callback in the test runner, the callback
+    will only be run once the runner is started (or maybe not at all,
+    if the test is filtered out).
+
     :param String name:
     :param TestOptions options:
     :param callback: