Skip to content

docs: correct MT provider list and AI Translator context availability - #1133

Open
JanCizmar wants to merge 1 commit into
mainfrom
jancizmar/fix-mt-providers-and-ai-context-docs
Open

docs: correct MT provider list and AI Translator context availability#1133
JanCizmar wants to merge 1 commit into
mainfrom
jancizmar/fix-mt-providers-and-ai-context-docs

Conversation

@JanCizmar

Copy link
Copy Markdown
Member

Two statements in the docs do not match the product. Both were found while verifying Tolgee feature availability against the platform source for a comparison page.

Machine translation providers

platform/translation_process/machine_translation.mdx listed four external providers. The product ships five: MtServiceType has GOOGLE, AWS, DEEPL, AZURE and BAIDU, and Baidu Translate has its own configuration section in the self-hosting docs (tolgee.machine-translation.baidu).

Added Baidu, marked self-hosted only since it is configured with your own API key via server configuration.

AI Translator context

platform/translation_process/ai_translator.mdx said Tolgee Context is "available only in the Cloud version with SDK 5.9.0 and higher". It is not Cloud only. The SDK 5.9.0 requirement is the real constraint, so the note now states just that.

Why this matters

Both statements understate what Tolgee does, and a competitor comparison page repeated one of them because our own docs said it. The provider count in particular was used to score a competitor claim as wrong when the competitor was right.

Not covered here

Three further inaccuracies live on tolgee.io/pricing, which is not in this repo:

  • The AI translator is marked N/A on the Free plan. No such gate exists in the code; LlmProviderController has no @RequiresFeatures and there is no AI translator feature in the Feature enum.
  • Included MT credits for Team and Advanced disagree with the billing API (10,000 vs 200,000, and 1,000,000 vs 2,000,000).
  • The Advanced extra-seat price disagrees with the billing API (EUR 22 vs 16).

Two statements on the docs did not match the product.

The machine translation provider list omitted Baidu Translate. It is a real
provider (MtServiceType.BAIDU) with its own configuration section in the
self-hosting docs, so the list showed four external providers where the product
ships five.

The AI Translator context note said the functionality is Cloud only. It is not
Cloud only; the SDK 5.9.0 requirement is the actual constraint.

Both were found while verifying plan gating and feature availability against the
platform source.
@netlify

netlify Bot commented Aug 5, 2026

Copy link
Copy Markdown

Deploy Preview for tolgee-docs failed.

Name Link
🔨 Latest commit 262448d
🔍 Latest deploy log https://app.netlify.com/projects/tolgee-docs/deploys/6a731f5dd2fd3b0008def0a4

@Barush

Barush commented Aug 10, 2026

Copy link
Copy Markdown
Member

@JanCizmar Build fails on a broken link.

/platform/self_hosting/configuration links to /self_hosting/running_with_docker#migrate-from-the-bundled-database, which is missing the /platform prefix.

@Barush
Barush self-requested a review August 10, 2026 06:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants