Add usage information for several endpoints

[ouya-store-api.git] / api / devs.ouya.tv / api-firmware_builds.rst

diff --git a/api/devs.ouya.tv/api-firmware_builds.rst b/api/devs.ouya.tv/api-firmware_builds.rst
index 3c9ad092985106d244ead5850062ddac95a37beb..6236adf6d69164ae45af614ec2ec681cb3e373c6 100644 (file)
--- a/api/devs.ouya.tv/api-firmware_builds.rst
+++ b/api/devs.ouya.tv/api-firmware_builds.rst
@@ -5,6 +5,14 @@
 List the latest available firmware version.
 
 
+Usage
+=====
+
+#. During the OUYA setup (Parameter ``oobe=true`` is set)
+#. During bootup
+#. Every 3 minutes unless an "Expires" header is set
+
+
 HTTP request
 ============
 Protocol
@@ -28,11 +36,9 @@ GET parameters
   ``oobe``
     ``true``
 
-    Can be omitted.
-
-    Does not seem to have any influence on the response.
+    Optional.
 
-    FIXME: what is that for? "Out Of (the) Box Experience"? Does it change anything?
+    Is set once during the OUYA setup (Out Of Box Experience).
 
 
 HTTP response