ENGDOCS-1255 (#16834)

* ENGDOCS-1255

* tidy

* edits from review

billing/cycle.md

@@ -4,11 +4,14 @@ description: how to change yor billing cycle in Docker Hub
 keywords: billing, cycle, payments, 
 ---
 
-You can pay for a Personal, Pro, or Team subscription on a monthly or yearly billing cycle.
+You can pay for a Pro or Team subscription on a monthly or yearly billing cycle.
 
-If you currently have a monthly billing cycle, you can choose to switch to an annual billing cycle. 
+If you currently have a monthly billing cycle, you can choose to switch to an annual billing cycle. Note that it's not possible to switch from an annual billing cycle to monthly. 
 
-When you change the billing cycle's duration, the subscription moves to the new billing cycle on the next billing date. To check the billing date, see [FAQs](faqs.md).
+When you change the billing cycle's duration:
+- The subscription moves to the new billing cycle on the next billing date. To check the billing date, see [FAQs](faqs.md#where-can-i-view-my-billing-date).
+- The subscription's start date is reset. For example, if the start date of the monthly subscription is March 1st and the end date is April 1st, then after switching the billing duration to March 15th 2023 the new start date is March 15th, 2023, and the new end date is March 15th, 2024.
+- Any unused monthly subscription is prorated and applied as credit towards the new annual period. For example, if the monthly subscription cost is $10 per month and the annual cost is $100 per year, then taking the above example into account, the unused value of the monthly subscription is $5, and the migration cost would be $95 ($100 - $5). The renewal cost after March 15, 2024 is $100.
 
 ## Personal account
 

billing/details.md

@@ -6,7 +6,7 @@ keywords: payments, billing, subscription, contact
 
 Find information on how to update the contact information for your personal account or for an organization. 
 
-The email address provided is where Docker sends all invoices and other billing-related communication.
+The contact information provided appears on all your billing invoices. The email address provided is where Docker sends all invoices and other billing-related communication. For more information on the billing emails you recieve, see [FAQs](faqs.md#what-billing-related-emails-will-i-receive-from-docker-hub)
 
 ## Personal account
 

billing/faqs.md

@@ -28,4 +28,15 @@ If your subscription payment fails, there is a grace period of 15 days, includin
 
 Docker also sends an email notification `Action Required - Credit Card Payment Failed` with an attached unpaid invoice after each failed payment attempt. 
 
-Once the grace period is over and the invoice is still not paid, the subscription is downgraded to a free plan and all paid features are disabled. 
+Once the grace period is over and the invoice is still not paid, the subscription is downgraded to a free plan and all paid features are disabled. 
+
+## What billing-related emails will I receive from Docker Hub?
+
+Docker Hub sends the following billing-related emails:
+
+- Confirmation of a new subscription.
+- Confirmation of paid invoices. 
+- Notifications of credit or debit card payment failures. 
+- Notifications of credit or debit card expiration. 
+- Confirmation of a cancelled subscription 
+- Reminders of subscription renewals for annual subscribers. This is sent 14 days before the renewal date. 

billing/payment-method.md

@@ -4,10 +4,14 @@ description: Information on how to add or update a payment method in Docker Hub
 keywords: payments, billing, subscription
 ---
 
-Find information on how to add or update edit a payment method for your personal account or for an organization. 
+Find information on how to add or update a payment method for your personal account or for an organization. 
 
 You can add a payment method or update your account's existing payment method at any time.
 
+>**Important**
+>
+> If you want to remove all payment methods, you must first downgrade your subscription to a free plan. See [Downgrade](../subscription/downgrade.md), for more information. 
+
 ## Personal account
 
 1. Select **Your Account** in the top-right corner of Docker Hub.
@@ -16,7 +20,7 @@ You can add a payment method or update your account's existing payment method at
 4. In the **Payment information** section, enter the new payment method. 
     The screen refreshes and displays your new payment information alongside your existing information.
 5. Select **Make Default** to ensure that your new payment method applies to all purchases and subscriptions. 
-6. Optional: Remove your existing payment method by selecting the **X** icon. 
+6. Optional: Remove your existing payment method by selecting the **X** icon.
 
 ## Organization