docs(retries): add documentation for retry mechanisms

this adds documentation for the new retry mechanisms for public-offer
update workflows and private-offer create.

Author: rpocase

docs/private-offer/index.rst

@@ -1,6 +1,34 @@
 How to create a private offer
 =============================
 
+Retry behavior for change-set workflows
+--------------------------------------
+
+Commands that submit Marketplace change sets now support retry options for transient contention failures.
+
+Retry flags:
+
+- ``--retry-max-retries`` (default: ``0``; retries are opt-in)
+- ``--retry-initial-delay-seconds`` (default: ``60``)
+- ``--retry-max-delay-seconds`` (default: ``300``)
+
+Supported private-offer workflow:
+
+- ``awsmp private-offer create``
+
+Example:
+
+.. code-block:: sh
+
+   awsmp private-offer create \
+      --product-id 3a628887-30de-4d23-a949-93b32e4e4c5f \
+      --buyer-accounts 887450378614 \
+      --customer-name "toabctl testing" \
+      --pricing prices.csv \
+      --retry-max-retries 3 \
+      --retry-initial-delay-seconds 60 \
+      --retry-max-delay-seconds 300
+
 To create a private offer in the `AWS marketplace management portal`_, use the API calls described below.
 
 

docs/public-offer/index.rst

@@ -1,6 +1,43 @@
 How to create a public offer
 ============================
 
+Retry behavior for change-set workflows
+--------------------------------------
+
+Commands that submit Marketplace change sets now support retry options for transient contention failures such as:
+
+- ``Requested change set has entities locked by change sets``
+- ``maximum service quota limit ... entities ... updated concurrently``
+
+Retry flags:
+
+- ``--retry-max-retries`` (default: ``0``; retries are opt-in)
+- ``--retry-initial-delay-seconds`` (default: ``60``)
+- ``--retry-max-delay-seconds`` (default: ``300``)
+
+Supported public-offer workflows:
+
+- ``awsmp public-offer create``
+- ``awsmp public-offer update-description``
+- ``awsmp public-offer update-instance-type``
+- ``awsmp public-offer update-region``
+- ``awsmp public-offer update-version``
+- ``awsmp public-offer update-legal-terms``
+- ``awsmp public-offer update-support-terms``
+- ``awsmp public-offer release``
+- ``awsmp public-offer update``
+
+Example:
+
+.. code-block:: sh
+
+   awsmp public-offer update \
+      --product-id prod-fwu3xsqup23cs \
+      --config listing_configuration.yaml \
+      --retry-max-retries 3 \
+      --retry-initial-delay-seconds 60 \
+      --retry-max-delay-seconds 300
+
 To create a new public AMI product listing in the `AWS marketplace management portal`_, use the API calls described below: