@@ -164,7 +164,7 @@ types:
                                             This endpoint does not provide paging capabilities.
                                             For stream log types, the type line header characters are dropped.
                                             'text/plain' is used as the mime type except for html logs, where 'text/html' is used.
-                                            The 'slug' is used as the filename for the resulting download. Some browsers are appending ".txt" or ".html" to this filename according to the mime-type.
+                                            The 'slug' is used as the filename for the resulting download. Some browsers are appending ``".txt"`` or ``".html"`` to this filename according to the mime-type.
                                         is:
                                         - bbgetraw:
 
 
@@ -76,3 +76,13 @@ def test_endpoints_by_type(self):
         self.assertIn(
             "/masters/{masterid}/builders/{builderid}/workers/{workerid}",
             self.api.endpoints_by_type['worker'].keys())
+
+    def test_iter_actions(self):
+        build = self.api.endpoints_by_type['build']
+        actions = dict(self.api.iter_actions(build['/builds/{buildid}']))
+        self.assertEqual(sorted(actions.keys()), sorted(['rebuild', 'stop']))
+
+    def test_rawendpoints(self):
+        self.assertIn(
+            "/steps/{stepid}/logs/{log_slug}/raw",
+            self.api.rawendpoints.keys())
@@ -38,10 +38,14 @@ def __init__(self):
         # waiting for raml1.0 support in ramlfications
         # we cannot use its raml parser
         # so we just use its loader
-        self.api = ramlfications.load(os.path.join(
-            os.path.dirname(__file__), os.pardir, 'spec', 'api.raml'))
+        fn = os.path.join(os.path.dirname(__file__), os.pardir, 'spec', 'api.raml')
+        self.api = ramlfications.load(fn)
+        with open(fn) as f:
+            self.rawraml = f.read()
+
         endpoints = {}
         self.endpoints_by_type = {}
+        self.rawendpoints = {}
         self.endpoints = self.parse_endpoints(endpoints, "", self.api)
         self.types = self.parse_types()
 
@@ -65,6 +69,9 @@ def parse_endpoints(self, endpoints, base, api, uriParameters=None):
                             v['eptype'] = _is['bbget']['bbtype']
                             self.endpoints_by_type.setdefault(v['eptype'], {})
                             self.endpoints_by_type[v['eptype']][base] = api
+                        if 'bbgetraw' in _is:
+                            self.rawendpoints.setdefault(base, {})
+                            self.rawendpoints[base] = api
         return endpoints
 
     def reindent(self, s, indent):
@@ -77,3 +84,13 @@ def format_json(self, j, indent):
     def parse_types(self):
         types = self.api['types']
         return types
+
+    def iter_actions(self, endpoint):
+        ACTIONS_MAGIC = '/actions/'
+        for k, v in endpoint.iteritems():
+            if k.startswith(ACTIONS_MAGIC):
+                k = k[len(ACTIONS_MAGIC):]
+                v = v['post']
+                # simplify the raml tree for easier processing
+                v['body'] = v['body']['application/json'].get('properties', {})
+                yield (k, v)
@@ -269,6 +269,17 @@ class BBDomain(Domain):
                                                           names=('pathkey',), typenames=('type',),
                                                           can_collapse=True),
                                            ]),
+        'raction': make_ref_target_directive('raction',
+                                           indextemplates=[
+                                               'single: Resource Action; %s',
+                                           ],
+                                           name_annotation='POST with method:',
+                                           has_content=True,
+                                           doc_field_types=[
+                                               TypedField('body', label='Body keys',
+                                                          names=('body',), typenames=('type',),
+                                                          can_collapse=True),
+                                           ]),
     }
 
     roles = {
@@ -300,8 +311,9 @@ class BBDomain(Domain):
         make_index("cmdline", "Command Line Index"),
         make_index("msg", "MQ Routing Key Index"),
         make_index("event", "Data API Event Index"),
-        make_index("rtype", "Data API Resource Type Index"),
-        make_index("rpath", "Data API Path Index"),
+        make_index("rtype", "REST/Data API Resource Type Index"),
+        make_index("rpath", "REST/Data API Path Index"),
+        make_index("raction", "REST/Data API Actions Index"),
     ]
 
     def resolve_xref(self, env, fromdocname, builder, typ, target, node,
 
@@ -14,6 +14,8 @@ It is also designed, in keeping with REST principles, to be discoverable.
 As such, the details of the paths and resources are not documented here.
 Begin at the root URL, and see the :ref:`Data_API` documentation for more information.
 
+.. contents:: :local:
+
 Versions
 ~~~~~~~~
 
@@ -168,9 +170,6 @@ Raml Specs
 The Data API is documented in `RAML 1.0 format <https://github.com/raml-org/raml-spec/blob/master/versions/raml-10/raml-10.md>`_.
 RAML describes and documents all our data, rest, and javascript APIs in a format that can be easily manipulated by human and machines.
 
-.. toctree::
-    :maxdepth: 2
-
 .. jinja:: data_api
 
     {% for name, type in raml.types.items()|sort %}
@@ -211,7 +210,7 @@ RAML describes and documents all our data, rest, and javascript APIs in a format
 
     {{type.description}}
     {% endif %}
-    {% if name in raml.endpoints_by_type -%}
+    {% if name in raml.endpoints_by_type -%}{# if type has endpoints #}
     Endpoints
     ---------
     {% for ep, config in raml.endpoints_by_type[name].items()|sort -%}
@@ -230,7 +229,45 @@ RAML describes and documents all our data, rest, and javascript APIs in a format
             :bb:rtype:`collection` of :bb:rtype:`{{method_ep['eptype']}}`
         {% endif %}
 
-    {% endif %}
-    {% endfor %}
-    {% endif %}
+    {% endif %}{# if ep has get #}
+
+    {% for method, action in raml.iter_actions(config) -%}
+    .. bb:raction:: {{ep}}:{{method}}
+
+        :body string method:  must be ``{{ method }}``
+
+        {% for key, value in action['body'].items() -%}
+        :body {{value.type}} {{key}}: {{raml.reindent(value.description, 4*2)}}
+        {% endfor %}
+
+    {% endfor %}{# endpoints #}
+    {% endfor %}{# endpoints #}
+    {% endif %}{# if type has endpoints #}
+    {% endfor %}{# for each types #}
+
+    Raw endpoints
+    .............
+
+    Raw endpoints allow to download content in their raw format (i.e. not within a json glue).
+    The ``content-disposition`` http header is set, so that the browser knows which file to store the content to.
+
+    {% for ep, config in raml.rawendpoints.items()|sort %}
+
+    .. bb:rpath:: {{ep}}
+
+        {% for key, value in config.uriParameters.items() -%}
+            :pathkey {{value.type}} {{key}}: {{raml.reindent(value.description, 4*2)}}
+        {% endfor %}
+
+    {{config['get'].description}}
+
     {% endfor %}
+
+    Raml spec verbatim
+    ..................
+
+    Sometimes Raml is just clearer than formatted text.
+
+    .. code-block:: yaml
+
+        {{raml.reindent(raml.rawraml, 4*1)}}
@@ -12,5 +12,6 @@ Indices and Tables
 * :bb:index:`event`
 * :bb:index:`rtype`
 * :bb:index:`rpath`
+* :bb:index:`raction`
 * :ref:`modindex`
 * :ref:`search`
@@ -0,0 +1,29 @@
+Release Notes for Buildbot ``0.9.0rc4``
+========================================
+
+
+The following are the release notes for Buildbot ``0.9.0rc4``.
+This version was released on September 28, 2016.
+
+See :ref:`Upgrading to Nine` for a guide to upgrading from 0.8.x to 0.9.x
+
+
+Master
+------
+
+Fixes
+~~~~~
+
+* Fix the UI to better adapt to different screen width (:bug:`3614`)
+
+* Add more REST api documentation (document ``/raw`` endpoints, and ``POST`` actions)
+
+
+Details
+-------
+
+For a more detailed description of the changes made in this version, see the git log itself:
+
+.. code-block:: bash
+
+   git log v0.9.0rc3..v0.9.0rc4
@@ -60,7 +60,7 @@ For a more detailed description of the changes made in this version, see the git
 
 .. code-block:: bash
 
-   git log v0.9.0rc3..master
+   git log v0.9.0rc4..master
 
 Older Versions
 --------------
@@ -72,6 +72,7 @@ Newer versions are also available here:
     :maxdepth: 1
 
     0.9.0
+    0.9.0rc4
     0.9.0rc3
     0.9.0rc2
     0.9.0rc1
 
@@ -30,7 +30,7 @@ config =
         # JavaScript libraries (order matters)
         deps:
             "guanlecoja-ui":
-                version: '~1.6.1'
+                version: '~1.6.2'
                 files: ['vendors.js', 'scripts.js']
             moment:
                 version: "~2.6.0"