Documentation: Cloud Storage Utility (move-coop#350)

* Add docs.

* Add links.

* Lint.

docs/index.rst

@@ -211,6 +211,7 @@ Indices and tables
    dbsync
    table
    notifications
+   utilities
 
 .. toctree::
    :maxdepth: 1

docs/utilities.rst

@@ -0,0 +1,47 @@
+*********
+Utilities
+*********
+
+.. _cloud-storage:
+=============
+Cloud Storage
+=============
+The Parsons cloud storage utility was created to interact with APIs that require access to files
+to run an asynchronous process. While this utility currently only works with ``S3``, the goal
+is add functionality for additional cloud storage services in the future.
+
+The cloud storage utility is currently being utilitized primarily by the NGPVAN class
+methods such as :func:`~parsons.ngpvan.van.Scores.upload_scores` and Bulk Import methods.
+
+These methods have arguments specific their method, but all also contain the following cloud 
+storage arguments:
+
+* ``url_type`` - The type of cloud storage to utilize. Currently only ``S3``.
+
+* ``**url_kwargs`` - These are arguments specific to the cloud storage type in order to initialize.
+
+**S3**
+
+When you select the ``url_type`` S3, the Parsons table will be converted to a csv and compressed. The file will be posted to an S3 bucket. A presigned public url will be generated and returned. The url will be active by default for 60 minutes, however you may adjust that time.
+
+.. list-table::
+    :widths: 25 25 100
+    :header-rows: 1
+
+    * - Argument
+      - Required
+      - Description
+    * - ``bucket``
+      - Yes
+      - The S3 bucket to post the file
+    * - ``aws_access_key``
+      - No
+      - Required if ``AWS_ACCESS_KEY_ID`` env variable not set.
+    * - ``aws_secret_access_key``
+      - No
+      - Required if ``AWS_SECRET_ACCESS_KEY`` env variable not set.
+    * - ``public_url_expires``
+      - No
+      - Defaults is 60 minutes.
+
+

parsons/ngpvan/scores.py

@@ -148,7 +148,8 @@ def upload_scores(self, tbl, config, url_type, id_type='vanid', email=None, auto
                    {'score2_id' : int, score2_column': str}]
 
             url_type: str
-                The cloud file storage to use to post the file. Currently only ``S3``.
+                The cloud file storage to use to post the file.
+                See :ref:`Cloud Storage <cloud-storage>` for more details.
             email: str
                 An email address to send job load status updates.
             auto_approve: boolean
@@ -158,9 +159,8 @@ def upload_scores(self, tbl, config, url_type, id_type='vanid', email=None, auto
                 The deviation from the average scores allowed in order to automatically
                 approve the score. Maximum of .1.
             **url_kwargs: kwargs
-                Arguments to configure your cloud storage url type.
-                    * S3 requires ``bucket`` argument and, if not stored as env variables
-                      ``aws_access_key`` and ``aws_secret_access_key``.
+                Arguments to configure your cloud storage url type. See
+                :ref:`Cloud Storage <cloud-storage>` for more details.
         `Returns:`
             int
                The score load job id.