docs: reorder and rename subscription methods

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.
 

docs/docs/subscriptions/get-payment-link.md

@@ -1,8 +1,8 @@
 ---
-sidebar_position: 7
+sidebar_position: 10
 ---
 
-# Get a Subscription Update Payment Link
+# Get update payment link
 
 Returns the update payment link for 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 [Subscription Payment Link Object](https://docs.salable.app/api/v2#tag/Subscriptions/operation/getSubscriptionUpdatePaymentLink)
+For more information about this request, see our API documentation on [Subscription Payment Link Object](https://docs.salable.app/api/v2#tag/Subscriptions/operation/getSubscriptionUpdatePaymentLink)

docs/docs/subscriptions/get-payment-method.md

@@ -1,8 +1,8 @@
 ---
-sidebar_position: 10
+sidebar_position: 8
 ---
 
-# Get a Subscription Payment Method
+# Get payment method
 
 Returns the payment method used to pay for a subscription.
 
@@ -26,4 +26,4 @@ The UUID of the subscription
 
 ## Return Type
 
-For more information about this request see our API documentation on [Subscription Payment Method Object](https://docs.salable.app/api/v2#tag/Subscriptions/operation/getSubscriptionPaymentMethod)
+For more information about this request, see our API documentation on [Subscription Payment Method Object](https://docs.salable.app/api/v2#tag/Subscriptions/operation/getSubscriptionPaymentMethod)

docs/docs/subscriptions/get-seats.md

@@ -1,8 +1,8 @@
 ---
-sidebar_position: 1
+sidebar_position: 4
 ---
 
-# Get Subscription Seats
+# Get seats
 
 Returns a list of seats on a subscription. Seats with the status `CANCELED` are ignored. Response uses cursor-based pagination.
 

docs/docs/subscriptions/get-user-plans.md

@@ -1,10 +1,10 @@
 ---
-sidebar_position: 5
+sidebar_position: 6
 ---
 
-# Get Switchable Plans for a Subscribed User
+# Get switchable plans
 
-Returns the details of a single subscription.
+Returns the available plans the customer on the subscription can change to.
 
 ## Code Sample
 
@@ -26,4 +26,4 @@ The UUID of the subscription
 
 ## Return Type
 
-For more information about this request see our API documentation on [Subscription Object](https://docs.salable.app/api/v2#tag/Subscriptions/operation/getSubscriptionUpdatablePlans)
+For more information about this request, see our API documentation on [Subscription Object](https://docs.salable.app/api/v2#tag/Subscriptions/operation/getSubscriptionUpdatablePlans)

docs/docs/subscriptions/reactivate.md

@@ -1,8 +1,8 @@
 ---
-sidebar_position: 11
+sidebar_position: 15
 ---
 
-# Reactivate a Subscription
+# Reactivate
 
 This method reactivates a subscription scheduled for cancellation before the billing period has passed.
 

docs/docs/subscriptions/remove-seats.md

@@ -1,8 +1,8 @@
 ---
-sidebar_position: 13
+sidebar_position: 12
 ---
 
-# Remove Subscription Seats
+# Remove seats
 
 Remove seats from a Subscription. Seats can only be removed if they are unassigned. To unassign seats use the [update many](../licenses/update-many.md) method to set the `granteeId` of each seat to `null`.
 

docs/docs/subscriptions/update.md

@@ -2,7 +2,7 @@
 sidebar_position: 13
 ---
 
-# Update Subscription
+# Update subscription
 
 Update properties on a subscription.