Added info about statuses and Upload to AMO use case

docs/source/amo_integration/index.rst

@@ -13,3 +13,5 @@ Contents:
    :maxdepth: 2
 
    sync.rst
+   usecases.rst
+   statuses.rst

docs/source/amo_integration/statuses.rst

@@ -0,0 +1,29 @@
+.. _amo-statuses:
+
+===============
+Add-on statuses
+===============
+
+Every Add-on uploaded to AMO has a status which is one of the following:
+
+* ``STATUS_NULL`` - Incomplete
+* ``STATUS_UNREVIEWED`` - (**default**) - Awaiting Preliminary Review
+* ``STATUS_PENDING`` - Pending approval
+* ``STATUS_NOMINATED`` - Awaiting Full Review
+* ``STATUS_PUBLIC`` - Fully Reviewed
+* ``STATUS_DISABLED`` - Disabled by Mozilla
+* ``STATUS_LISTED`` - Listed
+* ``STATUS_BETA`` - Beta
+* ``STATUS_LITE`` - Preliminarily Reviewed
+* ``STATUS_LITE_AND_NOMINATED`` - Preliminarily Reviewed and Awaiting Full Review
+* ``STATUS_PURGATORY`` - Pending a review choice
+
+The AMOStatus needs to be stored (and updated) within
+:class:`~jetpack.models.PackageRevision`.
+
+Builder adds another statuses:
+
+* ``STATUS_UPLOAD_SCHEDULED`` - Upload scheduled
+* ``STATUS_UPLOAD_FAILED`` - Upload failed
+
+If upload finished with success the default AMOStatus will be used. 

docs/source/amo_integration/usecases.rst

@@ -0,0 +1,24 @@
+.. _amo-usecases:
+
+=========
+Use Cases
+=========
+
+Upload to AMO
+#############
+
+* Add-on author clicks on the ``UploadToAMO`` link.
+
+* Builder validates if all fields are correct (especially if that Add-on with
+  the same version_name was already successfully uploaded to AMO).
+  
+* Builder is scheduling a task which creates ``XPI`` and, changes the status
+  to ``STATUS_UPLOAD_SCHEDULED`` and uploads it to AMO
+
+* User receives a notification ``Upload to AMO is scheduled, you can
+  leave the page``
+
+* After the upload has been done:
+  
+  * User receives a notification from AMO 
+  * Status is changed to default AMOStatus (``STATUS_UNREVIEWED``)