docs: Ordering Professional Translations

src/content/docs/crowdin/translation-process/ordering-professional-translations.mdx

@@ -5,4 +5,129 @@ sidebar:
   order: 3
 ---
 
-https://support.crowdin.com/ordering-professional-translations/
+[//]: # (https://support.crowdin.com/ordering-professional-translations/)
+
+import { Steps, Aside, LinkCard } from '@astrojs/starlight/components';
+import ReadMore from '~/components/ReadMore.astro';
+import { Image } from 'astro:assets';
+import vendors_list from './_assets/vendors_list.png';
+
+Crowdin provides localization services as a [Crowdin Language Services](/crowdin-language-services) vendor and cooperates with several other professional translation agencies that offer such services to Crowdin customers.
+
+<Image src={vendors_list} alt="Vendors list" class="no-shadow mb-8" />
+
+Some of them, like BLEND and Gengo are integrated with Crowdin via API, so the translation ordering becomes fully automated. When you purchase translations from them, Crowdin forwards your untranslated data directly to the agency. After the translations are completed, they're uploaded back to your Crowdin project, where you can download them to your machine.
+
+By selecting any other vendor from the list, you'll contact a real person who can be assigned to a project as a proofreader or project manager.
+They will manage the process for you: involve the translators, maintain the quality, monitor the progress, and meet the deadlines.
+
+Professional translation is a paid service where the approximate cost for your project is calculated or negotiated during the purchasing process.
+
+## Automated Translations Ordering
+
+You can order the translation from BLEND and Gengo in a few clicks. See the detailed instructions below.
+
+### Connecting BLEND and Gengo with Crowdin
+
+Before you can order translations from BLEND and Gengo, you need to have a Customer account on their platforms and sufficient balance.
+
+Register at <a href="https://app.getblend.com/auth/register" target="_blank">BLEND</a> and <a href="https://gengo.com/auth/form/signup/" target="_blank">Gengo</a> if you don't already have an account.
+
+To establish the connection between your customer account and your Crowdin account, follow these steps:
+
+<Steps>
+  1. Log in to Crowdin.
+
+  2. On your profile home page, open **Store** and select **Vendors**.
+
+  3. Select **BLEND** or **Gengo**.
+
+  4. Click **Connect Account**.
+     ![Connect BLEND](./_assets/blend_connect.png)
+
+  5. Enter *Public Key* and *Secret Key* from the BLEND <a href="https://app.getblend.com/profile/#apikeys" target="_blank">API keys</a> tab or the Gengo <a href="https://gengo.com/account/api_settings/" target="_blank">API settings</a>. Click **Submit Keys**.
+</Steps>
+
+### Creating Translation Tasks
+
+To send the localization content to BLEND or Gengo, you need to create tasks in the Crowdin project. Follow these step-by-step instructions for task creation:
+
+<Steps>
+  1. Click **Create Task** using the project's **Tasks** tab or straight from the vendor page via **Store > Vendors** being logged in as a project owner. Ensure to select the project from the drop-down list when creating a task via **Store > Vendors**.
+     ![Create Task](./_assets/blend_create_task.png)
+
+     <Aside>Project managers can create tasks for vendors only using the project's [Tasks](/tasks) tab.</Aside>
+
+  2. Set the [task parameters](#task-parameters).
+
+  3. Click **Create Task** to complete the translation order.
+</Steps>
+
+### Translation Process
+
+When the task is created, it’s automatically sent to the selected vendor. As soon as translation starts, the related task in Crowdin will automatically change the status to *In Progress*. And when the translations are finished, the task will gain the *Done* status in Crowdin.
+
+<ReadMore>
+  Read more about [BLEND Integration](/blend-integration).
+</ReadMore>
+
+## Ordering Translations With a Dedicated Manager
+
+The dedicated project manager will manage the translation process for you (involve translators, meet the deadlines, and maintain quality).
+
+To start working with a vendor, follow these steps:
+
+<Steps>
+  1. Log into your Crowdin account.
+
+  2. On your profile home page, open **Store** and select **Vendors**.
+
+  3. Click **View all vendors** to open the full list.
+
+  4. Select the preferred vendor.
+
+  5. Click **View**.
+     ![Vendor View](./_assets/vendor_view.png)
+
+  6. Select a project you'd like to translate.
+
+  7. Click **Create Task**.
+     Alternatively, click **Create Task** using the [Tasks](/tasks) tab in your project.
+
+  8. Set the [task parameters](#task-parameters).
+
+  9. Click **Create Task**.
+</Steps>
+
+<LinkCard
+  title="Crowdin Language Services"
+  description="Crowdin Language Services is an integrated solution that allows you to order professional translations and proofreading services for your Crowdin project in a few clicks"
+  href="/crowdin-language-services"
+/>
+
+## Task parameters
+
+| Parameter                                        | Description                                                                                                                      |
+|--------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------|
+| **Task Name** (required)                         | Specify the name of the task that will be visible to translators                                                                 |
+| **Description**                                  | Add more details about the task that might be useful for translators                                                             |
+| **Type** (required)                              | Select the task type                                                                                                             |
+| **Translation Vendor** (required)                | Select a vendor you'd like to work with                                                                                          |
+| **Due Date**                                     | Set a deadline                                                                                                                   |
+| **Expertise**                                    | Define the expertise that best suits your project                                                                                |
+| **Tone**                                         | Define the preferred tone of translations (Specific to Gengo)                                                                    |
+| **Purpose**                                      | Define where the translations are intended to be used (Specific to Gengo)                                                        |
+| **Comment**                                      | Provide the instructions for translators (Specific to Gengo)                                                                     |
+| **Include edit service**                         | Select this option if you'd like your translations to go through the additional review (Specific to Gengo)                       |
+| **Use preferred translators**                    | Select this option if you'd like to give priority for the translation order to your preferred translator (Specific to Gengo)     |
+| **Strings** (required)                           | Define if all untranslated strings should be available for translation or only those that were modified within a specific period |
+| **Skip strings already included in other tasks** | Select or clear this option depending on your preferences                                                                        |
+| **Skip untranslated strings**                    | Define whether untranslated strings should be skipped from the task                                                              |
+| **Filter by labels**                             | Select labels to include only strings with the specified labels in the task                                                      |
+| **Exclude by labels**                            | Select labels to exclude strings with the specified labels from the task                                                         |
+| **Files** or **Branches** (required)             | Depending on your project type, select the files or branches that should be translated                                           |
+| **Languages** (required)                         | Select target languages (a separate task will be created for each selected language)                                             |
+
+<ReadMore>
+  Read more about [Tasks](/tasks).
+</ReadMore>

src/global.css

@@ -9,7 +9,7 @@
 }
 
 /* Style for Markdown images */
-.sl-markdown-content img {
+.sl-markdown-content img:not(.no-shadow) {
     border-radius: 10px;
     border: 1px solid var(--sl-color-gray-6);
     box-shadow: var(--sl-shadow-sm);