docs: reorder and rename subscription methods

Author: avst-perrygeorge

docs/docs/subscriptions/add-seats.md

@@ -1,10 +1,10 @@
 ---
-sidebar_position: 12
+sidebar_position: 11
 ---
 
-# Increment Subscription Seats
+# Add seats
 
-Adds seats to a Subscription. Initially the seats will be unassigned. To assign granteeIds to the seats use the [update many](../licenses/update-many.md) method.
+Adds seats to a Subscription. Initially, the seats will be unassigned. To assign granteeIds to the seats, use the [manage seats](./manage-seats.md) method.
 
 ## Code Sample
 

docs/docs/subscriptions/cancel.md

@@ -1,8 +1,8 @@
 ---
-sidebar_position: 6
+sidebar_position: 17
 ---
 
-# Cancel a Subscription
+# Cancel
 
 Cancels a Subscription with options for when it terminates.
 

docs/docs/subscriptions/change-plan.md

@@ -1,10 +1,10 @@
 ---
-sidebar_position: 3
+sidebar_position: 14
 ---
 
-# Change a Subscription's Plan
+# Change plan
 
-Move a Subscription to a new Plan. Proration behaviour can optionally be set.
+Move a Subscription to a new Plan. If the subscription was created through a checkout link, proration behaviour can optionally be set.
 
 ## Code Sample
 

docs/docs/subscriptions/create.md

@@ -2,7 +2,7 @@
 sidebar_position: 1
 ---
 
-# Create Subscription
+# Create
 
 Create a subscription with no payment integration.
 

docs/docs/subscriptions/get-all.md

@@ -1,8 +1,8 @@
 ---
-sidebar_position: 1
+sidebar_position: 2
 ---
 
-# Get All Subscriptions
+# Get all
 
 Returns a list of all the subscriptions created by your Salable organization.
 

docs/docs/subscriptions/get-cancel-subscription-link.md

@@ -2,7 +2,7 @@
 sidebar_position: 9
 ---
 
-# Get Cancel Subscription Link
+# Get cancel link
 
 Returns a link to cancel a specific subscription.
 
@@ -26,4 +26,4 @@ The UUID of the subscription
 
 ## Return Type
 
-For more information about this request see our API documentation on [Cancel Subscription Link Object](https://docs.salable.app/api/v2#tag/Subscriptions/operation/getSubscriptionCancelLink)
+For more information about this request, see our API documentation on [Cancel Subscription Link Object](https://docs.salable.app/api/v2#tag/Subscriptions/operation/getSubscriptionCancelLink)

docs/docs/subscriptions/get-count.md

@@ -2,7 +2,7 @@
 sidebar_position: 5
 ---
 
-# Get Subscription Seat Count
+# Get seat count
 
 This method returns the aggregate number of seats. The response is broken down by assigned, unassigned and the total. Seats with the status `CANCELED` are ignored.
 

docs/docs/subscriptions/get-customer-portal-link.md

@@ -1,8 +1,8 @@
 ---
-sidebar_position: 8
+sidebar_position: 9
 ---
 
-# Get a Customer Portal Link for a Subscription
+# Get customer portal link
 
 Returns the customer portal link for a subscription.
 
@@ -26,4 +26,4 @@ The UUID of the subscription to be returned
 
 ## Return Type
 
-For more information about this request see our API documentation on [Subscription Portal Link Object](https://docs.salable.app/api/v2#tag/Subscriptions/operation/getSubscriptionCustomerPortalLink)
+For more information about this request, see our API documentation on [Subscription Portal Link Object](https://docs.salable.app/api/v2#tag/Subscriptions/operation/getSubscriptionCustomerPortalLink)

docs/docs/subscriptions/get-invoices.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 4
+sidebar_position: 7
 ---
 
 # Get Subscription Invoices
@@ -35,4 +35,4 @@ _Type:_ `GetAllInvoicesOptions`
 
 ## Return Type
 
-For more information about this request see our API documentation on [Subscription Invoice Object](https://docs.salable.app/api/v2#tag/Subscriptions/operation/getSubscriptionInvoices)
+For more information about this request, see our API documentation on [Subscription Invoice Object](https://docs.salable.app/api/v2#tag/Subscriptions/operation/getSubscriptionInvoices)

docs/docs/subscriptions/get-one.md

@@ -1,8 +1,8 @@
 ---
-sidebar_position: 2
+sidebar_position: 3
 ---
 
-# Get One Subscription
+# Get a subscription
 
 Returns the details of a single subscription.