more docs stuff

docs/api/index.rst

@@ -33,14 +33,16 @@ Quickstart
 
 Details on an app: https://marketplace.firefox.com/api/v1/apps/app/twitter/?format=JSON
 
-Search for apps: https://marketplace.firefox.com/api/v1/apps/search/?format=JSON
+Search for all hosted apps about Twitter: https://marketplace.firefox.com/api/v1/apps/search/?q=twitter&app_type=hosted&format=JSON
 
 Questions
 =========
 
 Contact us in the #marketplace channel on irc.mozilla.org.
 
-Bugs or feature requests are filed in `Bugzilla`_.
+Bugs or feature requests are filed in `Bugzilla`_. The code for the API
+and the source of these docs is part of the `zamboni project`_.
 
 .. _`Firefox Marketplace`: https://marketplace.firefox.com
 .. _`Bugzilla`: https://bugzilla.mozilla.org/buglist.cgi?list_id=6405232&resolution=---&resolution=DUPLICATE&query_format=advanced&component=API&product=Marketplace
+.. _`zamboni project`: https://github.com/mozilla/zamboni

docs/api/topics/apps.rst

@@ -284,4 +284,4 @@ Valid transitions that users can initiate are:
 * *disabled_by_user*: by changing this value from `True` to `False` you can
   enable or disable an app.
 
-.. _`terms of use`: https://marketplace.firefox.com/developers/api
+.. _`terms of use`: https://marketplace.firefox.com/developers/terms

docs/api/topics/reviewers.rst

@@ -15,27 +15,11 @@ Reviewing
 
 .. http:get::  /api/v1/reviewers/reviewing/
 
-   Returns a list of apps that are being reviewed.
+    Returns a list of apps that are being reviewed.
 
-   **Request**:
+    **Response**:
 
-   .. sourcecode:: http
+    :param meta: :ref:`meta-response-label`.
+    :param objects: A :ref:`listing <objects-response-label>` of :ref:`apps <app-response-label>`.
 
-      GET /api/v1/reviewers/reviewing/
-
-   **Response**:
-
-   .. sourcecode:: http
-
-      {
-        "meta": {
-            "previous": None, ...
-        },
-        "objects': [
-            {
-                "resource_uri": "/api/v1/apps/app/337141/"
-            }
-        ]
-      }
-
-   :statuscode 200: no error
+    :status 200: successfully completed.

docs/api/topics/site.rst

@@ -116,8 +116,8 @@ Regions
             "default_language": "en-AP"
         }
 
-Site configuration
-==================
+Configuration
+=============
 
 .. http:get:: /api/v1/services/config/site/