feat: order translation docs (#746)

Author: stepan662

blog/2024-11-14-order-professional-translation.mdx

@@ -0,0 +1,43 @@
+---
+slug: order-professional-translation
+title: 'Introducing Tolgee’s New Professional Translation Feature! 🌍✨'
+description: "Expand globally with Tolgee’s new professional translation feature—easily order, manage, and collaborate with agencies in one platform!"
+image: /img/blog/order-translation/cover-light.webp
+authors: [sgranat]
+tags: ['tolgee', 'dobco', 'next.js', 'integration']
+---
+
+import ThemedImage from '@theme/ThemedImage';
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
+<ThemedImage
+  alt="CSV Support Blog image"
+  sources={{
+    light: useBaseUrl(
+      '/img/blog/order-translation/cover-light.webp'
+    ),
+    dark: useBaseUrl(
+      '/img/blog/order-translation/cover-dark.webp'
+    ),
+  }}
+/>
+
+<!-- truncate-->
+
+Expand Your Reach with Tolgee’s New Professional Translation Feature! 🌍✨
+
+Tolgee's latest feature—Order Professional Translation—makes it easier than ever to connect with global audiences by bringing expert translations directly into your project workflow! 🚀
+
+### With just a few clicks, you can:
+
+ - Select a trusted agency from within Tolgee 🌐
+ - Create translation tasks tailored to your specific needs 🎯
+ - Collaborate seamlessly with your chosen agency right in the platform 🤝
+
+No more juggling with translation files! This feature keeps everything in one place, giving you more time to focus on what you do best while Tolgee handles the translation process effortlessly. 🌟
+
+### Ready to go global?
+
+🌏 This feature is available for business and enterprise plans—unlock it today and start reaching new audiences with ease! For more info [check the documentation](/platform/projects_and_organizations/order_translation).
+
+[![React banner](/img/blog/blog-banners/banner-demo.webp)](https://app.tolgee.io/sign_up)

package-lock.json

@@ -42,6 +42,7 @@
     "@types/react-router-dom": "^5.1.7",
     "@types/styled-components": "5.1.14",
     "@typescript-eslint/parser": "^7.5.0",
+    "@untitled-ui/icons-react": "^0.1.3",
     "autoprefixer": "10.4.7",
     "clsx": "^1.1.1",
     "docusaurus-plugin-image-zoom": "^1.0.1",

package.json

@@ -0,0 +1,88 @@
+---
+id: order_translation
+title: Ordering professional translation
+---
+
+import { ScreenshotWrapper } from '../shared/_ScreenshotWrapper';
+
+:::info Feature availability
+Professional translations are introduced in business and enterprise plans. [Upgrade your plan](https://tolgee.io/pricing) to use this feature.
+
+The feature is only available in Tolgee Cloud.
+:::
+
+## Ordering professional translation
+
+Go to the `Tasks` section in the project menu and click the `[Buy] Translation` button:
+
+<ScreenshotWrapper
+  src="/img/docs/platform/order-translation/order-translation-empty.webp"
+  alt="Tasks page with order translation button"
+/>
+
+You can also order translation directly from batch operations, to select exectly which keys should be included.
+
+<ScreenshotWrapper
+  src="/img/docs/platform/order-translation/order-translation-batch-operation.webp"
+  alt="Task batch operations"
+/>
+
+You will see a list of agencies to pick. Select the agency and follow the `Next` step.
+
+<ScreenshotWrapper
+  src="/img/docs/platform/order-translation/order-translation-agencies.webp"
+  alt="Order translation agencies list"
+/>
+
+Now, you can create a task for the agency, similar to a [regular task](./tasks.mdx). You can filter which languages and keys to include.
+
+<ScreenshotWrapper
+  src="/img/docs/platform/order-translation/order-translation-task.webp"
+  alt="Order translation task creation"
+/>
+
+You can invite the agency to your project immediately (with VIEW permissions).
+
+## What happens next?
+
+Once you `Request quote`, an agency task is created for each language.
+
+<ScreenshotWrapper
+  src="/img/docs/platform/order-translation/order-translation-agency-tasks.webp"
+  alt="Agency task"
+/>
+
+The agency will receive your request with an overview of the tasks (number of keys, words and characters).
+
+They'll also receive your email address and contact you with a price estimate and you'll get an order confirmation on your email.
+
+## Agency access to the project
+
+You should see a pending invitation in the `Members` section if you've invited agency directly into the project. 
+
+<ScreenshotWrapper
+  src="/img/docs/platform/order-translation/order-translation-invitation.webp"
+  alt="Agency invitation"
+/>
+
+If you want to invite an agency later, you can do the same operation through the `Invite user` button. In the dialog, click on the `Agency tab`.
+
+<ScreenshotWrapper
+  src="/img/docs/platform/order-translation/order-translation-invitation-dialog.webp"
+  alt="Agency invitation dialog"
+/>
+
+Once someone from the agency accepts the invitation, you'll see his account in the `Members` section.
+
+<ScreenshotWrapper
+  src="/img/docs/platform/order-translation/order-translation-member.webp"
+  alt="Agency member"
+/>
+
+All the agency members are marked, and you can filter them to see who has access to your project.
+
+## Elevating agency permissions
+
+Depending on the requirements, you can change agency account permissions to `Translate`, `Review` or `Manage`. If you want the agency to work more independently, you can grant them `Manage` access. This will allow them to make changes to your project, like inviting more members and creating new tasks.
+
+Tolgee will mark all new users invited by the agency members as agency members as well, and all the tasks will also have an agency label. This way, you can easily distinguish what the agency is doing in your project.

platform/projects_and_organizations/order_translation.mdx

@@ -45,6 +45,14 @@ Next, you can select the batch operation you want to perform from the dropdown l
 
 - **Export translations** – This allows you to select exactly which keys you want to export, otherwise it works the same as [Export page](../projects_and_organizations/export.mdx).
 
+- **Create task** – This operation allows you to create translation/review task with precisely selected keys.
+  
+- **Add keys to task** - Add aditional keys to existing task.
+
+- **Remove keys from task** - Remove keys from existing task (only available when task is open).
+
+- **Order professional translation** - Order translation from external agency for selected keys.
+
 - **Add tags** – With this operation, you can add one or multiple tags to selected keys.
 
 - **Remove tags** – This operation removes one or multiple tags from selected keys if they have them.

platform/translation_keys/batch_operations.mdx

@@ -19,6 +19,7 @@ module.exports = {
         'projects_and_organizations/machine-translation-settings',
         'projects_and_organizations/ai-translation-customization',
         'projects_and_organizations/tasks',
+        'projects_and_organizations/order_translation',
         'projects_and_organizations/members',
         'projects_and_organizations/import',
         'projects_and_organizations/export',