docs(billing): Account and Organization settings, Billing section enh…

…ancements (#137)
crowdin · Sep 20, 2024 · e3e37e4 · e3e37e4
1 parent 6864205
commit e3e37e4
Show file tree

Hide file tree

Showing 8 changed files with 109 additions and 66 deletions.
diff --git a/src/content/docs/crowdin/billing/app-subscriptions.mdx b/src/content/docs/crowdin/billing/app-subscriptions.mdx
@@ -10,7 +10,7 @@ import { Steps, CardGrid, LinkCard } from '@astrojs/starlight/components';
 import { Image } from 'astro:assets';
 import subscription from '!/crowdin/billing/app_subscription.png';
 
-Crowdin Store offers 600+ apps you can install to extend Crowdin functionality, synchronize your content stored on a CMS, and more.
+Crowdin Store offers various apps you can install to extend Crowdin functionality, synchronize your content stored on a CMS, and more.
 
 <LinkCard
   title="Crowdin Store"
@@ -39,13 +39,13 @@ Once the 14-day trial period ends, you'll be asked to subscribe to continue usin
   5. Click **Proceed to payment** to complete the purchase.
 </Steps>
 
-## How App Subscriptions Work with Primary Crowdin Subscriptions
+## How App Subscriptions Work
 
-### Monthly Crowdin Subscription and App Subscription
+### Monthly Crowdin Subscription
 
 If you've subscribed for a monthly plan, on each new billing cycle (every month) your payment will include your primary Crowdin subscription and all your paid app subscriptions. For example, your primary Crowdin subscription is a Team plan ($179/month), and you're subscribing to a paid app that costs $139/month, which would result in a total of $318/month.
 
-### Annual Crowdin Subscription and App Subscription
+### Annual Crowdin Subscription
 
 If you've subscribed for an annual plan, your paid app subscriptions will be deducted from your account balance along with the primary Crowdin subscription pseudo-charges. For example, your primary Crowdin subscription is a Team plan ($1,800 billed annually and deducted from your Crowdin account balance as $150/month pseudo-charges), and you're subscribing to a paid app that costs $139/month, which would result in a total of $289 deducted from your account balance every month.
 

diff --git a/src/content/docs/crowdin/billing/changing-subscription-plan.mdx b/src/content/docs/crowdin/billing/changing-subscription-plan.mdx
@@ -6,7 +6,7 @@ sidebar:
   order: 2
 ---
 
-import { Steps, CardGrid, LinkCard } from '@astrojs/starlight/components';
+import { Steps, CardGrid, LinkCard, LinkButton } from '@astrojs/starlight/components';
 import { Image } from 'astro:assets';
 import ReadMore from '~/components/ReadMore.astro';
 import planUpgrade from '!/crowdin/billing/plan_upgrade.png';
@@ -27,11 +27,9 @@ A similar principle is also applicable to downgrades.
 
 Depending on your current subscription plan, some features might not be available. In such cases, you might notice the respective message in Crowdin UI informing you that to be able to use the feature, it's necessary to upgrade to a higher plan.
 
-For example, if your current subscription plan is Pro, features like Advanced reports and Custom domain name will become available once you upgrade to the Team subscription plan or higher.
+<LinkButton href="https://crowdin.com/pricing" icon="external" target="_blank">View Pricing</LinkButton>
 
-<ReadMore>
-  Read more on the [Pricing page](https://crowdin.com/pricing#pricing-compare-team-cooperation).
-</ReadMore>
+For example, if your current subscription plan is Pro, features like Advanced reports and Custom domain name will become available once you upgrade to the Team subscription plan or higher.
 
 <Image src={notAvailableFeature} alt="Not Available Feature" />
 

diff --git a/src/content/docs/crowdin/billing/crowdin-managed-services.mdx b/src/content/docs/crowdin/billing/crowdin-managed-services.mdx
@@ -6,7 +6,7 @@ sidebar:
   order: 3
 ---
 
-import { Steps, CardGrid, LinkCard } from '@astrojs/starlight/components';
+import { Steps, CardGrid, LinkCard, Card } from '@astrojs/starlight/components';
 import { Image } from 'astro:assets';
 import usageStats from '!/crowdin/billing/usage_statistics.png';
 import balanceManagement from '!/crowdin/billing/balance_management.png';
@@ -15,28 +15,30 @@ Crowdin offers a range of additional services that can significantly improve you
 
 ## Available Services
 
-Crowdin can manage the following paid services:
-
-- **MT engines** (e.g., DeepL Pro)
-- **AI models** (e.g., OpenAI, Google Gemini, and other providers)
-- **Translation vendors** (Crowdin Language Services)
+Crowdin can manage the following paid services without the need to register separate accounts.
 
 <CardGrid>
-  <LinkCard
-    title="Machine Translation"
-    description="Read more about Machine Translation and how to use it."
-    href="/machine-translation/"
-  />
-  <LinkCard
-    title="Crowdin AI"
-    description="Read more about Crowdin AI and how to use it."
-    href="/crowdin-ai/"
-  />
-  <LinkCard
-    title="Crowdin Language Services"
-    description="Order professional translations and proofreading services."
-    href="/crowdin-language-services/"
-  />
+  <Card title="MT Engines">
+    Leverage the DeepL Pro machine translation engines to automate the translation process.
+    <LinkCard
+      title="Read More"
+      href="/machine-translation/"
+    />
+  </Card>
+  <Card title="AI Models">
+    Improve localization workflow by using OpenAI, Google Gemini, and other providers.
+    <LinkCard
+      title="Read More"
+      href="/crowdin-ai/"
+    />
+  </Card>
+  <Card title="Translation Vendors">
+    Order professional translation and proofreading services with Crowdin Language Services.
+    <LinkCard
+      title="Read More"
+      href="/crowdin-language-services/"
+    />
+  </Card>
 </CardGrid>
 
 ## Using Crowdin Managed Services

diff --git a/src/content/docs/crowdin/getting-started/account/settings.mdx b/src/content/docs/crowdin/getting-started/account/settings.mdx
@@ -210,18 +210,44 @@ You can also configure notification preferences on the project level:
 
 The **Billing** tab in your **Account Settings** becomes available as soon as you subscribe to one of Crowdin's plans. Within this tab, you can manage your subscription plan, view payment history, handle app subscriptions, manage the balance for MT engines and AI models managed by Crowdin, and set the daily balance warning threshold for Over-The-Air Content Delivery.
 
+### Current Plan
+
 Review your current subscription plan, which includes details such as the plan name, the date of the last plan change, and your current usage limits (e.g., managers, projects, words). Additionally, you can view the next charge amount and the expiration date of your plan.
 
-To manage specific aspects of your billing, navigate to the following sections:
+<ReadMore>
+  Read more about [Changing Subscription Plan](/changing-subscription-plan/).
+</ReadMore>
+
+### App Subscription
+
+Crowdin Store offers various apps that you can install to extend the functionality of Crowdin, synchronize your content stored in a CMS, and more. Some of the apps are available for free, while others are paid.
+
+<ReadMore>
+  Read more about [App Subscriptions](/app-subscriptions/).
+</ReadMore>
+
+### Crowdin Managed Services
+
+Top up the balance for the Crowdin Managed Services (MT engines, AI models, Crowdin Language Services), set a balance warning threshold and view the usage statistics for each service.
+
+<ReadMore>
+  Read more about [Crowdin Managed Services](/crowdin-managed-services/).
+</ReadMore>
+
+### Over-The-Air Content Delivery
+
+Set a daily balance warning threshold for Over-The-Air Content Delivery and view the usage statistics.
+
+<ReadMore>
+  Read more about [Over-The-Air Content Delivery](/content-delivery/).
+</ReadMore>
+
+### Payments
 
-- **Current plan** &ndash; view your subscription plan details, including usage statistics and upcoming charges.
-- **App subscription** &ndash; manage app subscriptions.
-- **MT engines and AI models managed by Crowdin** &ndash; top up the balance for MT engines and AI models managed by Crowdin, and set a balance warning threshold.
-- **Over-The-Air Content Delivery** &ndash; set a daily balance warning threshold for Over-The-Air Content Delivery.
-- **Payments** &ndash; access payment history and download invoices.
+Access payment history and download invoices.
 
 <ReadMore>
-  Read more about [Payments and Invoices](/payments-invoices/), [Changing Subscription Plan](/changing-subscription-plan/), [App Subscriptions](/app-subscriptions/), and [Billing Settings](/billing-settings/).
+  Read more about [Payments and Invoices](/payments-invoices/) and [Billing Settings](/billing-settings/).
 </ReadMore>
 
 ## API

diff --git a/src/content/docs/enterprise/billing/app-subscriptions.mdx b/src/content/docs/enterprise/billing/app-subscriptions.mdx
@@ -10,7 +10,7 @@ import { Steps, CardGrid, LinkCard } from '@astrojs/starlight/components';
 import { Image } from 'astro:assets';
 import subscription from '!/enterprise/billing/app_subscription.png';
 
-Crowdin Store offers 600+ apps you can install to extend Crowdin functionality, synchronize your content stored on a CMS, and more.
+Crowdin Store offers various apps you can install to extend Crowdin functionality, synchronize your content stored on a CMS, and more.
 
 <LinkCard
   title="Crowdin Store"
@@ -39,7 +39,7 @@ Once the 14-day trial period ends, you'll be asked to subscribe to continue usin
   5. Click **Proceed to payment** to complete the purchase.
 </Steps>
 
-## How App Subscriptions Work with Primary Crowdin Enterprise Subscriptions
+## How App Subscriptions Work
 
 Since all Crowdin Enterprise subscription charged annually, your paid app subscriptions will be deducted from your account balance along with the primary Crowdin Enterprise subscription pseudo-charges. For example, your primary Crowdin Enterprise subscription is a Team+ plan ($5,400 billed annually and deducted from your Crowdin Enterprise account balance as $450/month pseudo-charges), and you're subscribing to a paid app that costs $139/month, which would result in a total of $589 deducted from your account balance every month.
 

diff --git a/src/content/docs/enterprise/billing/changing-subscription-plan.mdx b/src/content/docs/enterprise/billing/changing-subscription-plan.mdx
@@ -6,9 +6,8 @@ sidebar:
   order: 2
 ---
 
-import { Steps, CardGrid, LinkCard } from '@astrojs/starlight/components';
+import { Steps, CardGrid, LinkCard, LinkButton } from '@astrojs/starlight/components';
 import { Image } from 'astro:assets';
-import ReadMore from '~/components/ReadMore.astro';
 import planUpgrade from '!/enterprise/billing/plan_upgrade.png';
 import notAvailableFeature from '!/enterprise/billing/not_available_feature.png';
 
@@ -27,11 +26,9 @@ A similar principle is also applicable to downgrades.
 
 Depending on your current subscription plan, some features might not be available. In such cases, you might notice the respective message in Crowdin Enterprise UI informing you that to be able to use the feature, it's necessary to upgrade to a higher plan.
 
-For example, if your current subscription plan is Team+, features like SAML, Teams, and IP allowlist will become available once you upgrade to the Business subscription plan or higher.
+<LinkButton href="https://crowdin.com/pricing" icon="external" target="_blank">View Pricing</LinkButton>
 
-<ReadMore>
-  Read more on the [Pricing page](https://crowdin.com/pricing#pricing-compare-security-and-management).
-</ReadMore>
+For example, if your current subscription plan is Team+, features like SAML, Teams, and IP allowlist will become available once you upgrade to the Business subscription plan or higher.
 
 <Image src={notAvailableFeature} alt="Not Available Feature" />
 

diff --git a/src/content/docs/enterprise/billing/crowdin-managed-services.mdx b/src/content/docs/enterprise/billing/crowdin-managed-services.mdx
@@ -6,7 +6,7 @@ sidebar:
   order: 3
 ---
 
-import { Steps, CardGrid, LinkCard, Aside } from '@astrojs/starlight/components';
+import { Steps, CardGrid, LinkCard, Card } from '@astrojs/starlight/components';
 import { Image } from 'astro:assets';
 import usageStats from '!/enterprise/billing/usage_statistics.png';
 import balanceManagement from '!/enterprise/billing/balance_management.png';
@@ -15,22 +15,23 @@ Crowdin offers a range of additional services that can significantly improve you
 
 ## Available Services
 
-Crowdin can manage the following paid services:
-
-- **MT engines** (e.g., DeepL Pro)
-- **AI models** (e.g., OpenAI, Google Gemini, and other providers)
+Crowdin can manage the following paid services without the need to register separate accounts.
 
 <CardGrid>
-  <LinkCard
-    title="Machine Translation"
-    description="Read more about Machine Translation and how to use it."
-    href="/enterprise/machine-translation/"
-  />
-  <LinkCard
-    title="Crowdin AI"
-    description="Read more about Crowdin AI and how to use it."
-    href="/enterprise/crowdin-ai/"
-  />
+  <Card title="MT Engines">
+    Leverage the DeepL Pro machine translation engines to automate the translation process.
+    <LinkCard
+      title="Read More"
+      href="/enterprise/machine-translation/"
+    />
+  </Card>
+  <Card title="AI Models">
+    Improve localization workflow by using OpenAI, Google Gemini, and other providers.
+    <LinkCard
+      title="Read More"
+      href="/enterprise/crowdin-ai/"
+    />
+  </Card>
 </CardGrid>
 
 ## Using Crowdin Managed Services

diff --git a/src/content/docs/enterprise/organization-management/settings/general.mdx b/src/content/docs/enterprise/organization-management/settings/general.mdx
@@ -71,17 +71,36 @@ You can also manage authentication methods for user sign-ins. Use Crowdin Enterp
 
 In the **Billing** section, you can manage your subscription plan, view payment history, and handle app subscriptions. You can upgrade or downgrade your plan based on your needs, and access detailed information about your organization’s usage and invoicing.
 
+### Subscription Plan
+
 Review your current subscription plan, which includes details such as the plan name, the date of the last plan change, and your current usage limits. You can also see how many managers and words are currently used out of the total allowed, as well as the status of additional features like permission granularity and IP allowlist.
 
-To access more detailed information and manage specific aspects of your billing, navigate to the following sections:
+<ReadMore>
+  Read more about [Changing Subscription Plan](/enterprise/changing-subscription-plan/).
+</ReadMore>
+
+### App Subscriptions
+
+Crowdin Store offers various apps that you can install to extend the functionality of Crowdin Enterprise, synchronize your content stored in a CMS, and more. Some of the apps are available for free, while others are paid.
+
+<ReadMore>
+  Read more about [App Subscriptions](/enterprise/app-subscriptions/).
+</ReadMore>
+
+### View Payment History
+
+Access payment history and download invoices.
+
+<ReadMore>
+  Read more about [Payments and Invoices](/enterprise/payments-invoices/) and [Billing Settings](/enterprise/billing-settings/).
+</ReadMore>
+
+### Crowdin Managed Services
 
-- **Subscription plan** &ndash; view and modify your subscription plan.
-- **App subscriptions** &ndash; manage app subscriptions.
-- **View payment history** &ndash; access payment history and download invoices.
-- **MT engines and AI models managed by Crowdin** &ndash; top up the balance for MT engines and AI models managed by Crowdin, and set balance warning threshold.
+Top up the balance for the Crowdin Managed Services (MT engines, AI models), set a balance warning threshold and view the usage statistics for each service.
 
 <ReadMore>
-  Read more about [Payments and Invoices](/enterprise/payments-invoices/), [Changing Subscription Plan](/enterprise/changing-subscription-plan/), [App Subscriptions](/enterprise/app-subscriptions/), and [Billing Settings](/enterprise/billing-settings/).
+  Read more about [Crowdin Managed Services](/enterprise/crowdin-managed-services/).
 </ReadMore>
 
 ## Apps