Answering in two languages
Questions arrive in two languages and the documentation is written in one. Below are the rules that follow from that, and the glossary that keeps the terms in place.
- Both halves are translated: the question so that the Russian search finds anything, the answer so that it can be read. Two translations are two places to lose a term, which is why the glossary exists.
- Numbers are neither translated nor converted. Prices stay in roubles: the bot has no exchange rate, and an invented dollar figure is the worst thing that can happen in a conversation about money.
- Channel names, key names and menu items stay as they are. A translated menu item is a menu item that does not exist, and somebody will hunt for it until the end of the day.
- When the bot is unsure, the hedge is written in the language of the answer. A stray Russian line in the middle of an English reply reads as a glitch rather than as candour.
- The reply says that it was translated. Pretending the knowledge base is English is pointless: the first long explanation gives it away, and being found out costs more trust than saying so up front.
A question in a third language. The model will happily handle German or Spanish, but nobody here has proofread that output. So a question in a third language gets an English answer and a plain note saying why, rather than a pretence that we support ten languages.
Glossary
Pairs the translation is not allowed to replace with something of its own. On the left, what the Russian docs and the invoice call it; on the right, what the English interface shows.
- Замер → Zamer
- The product name. In an English answer it stays in Latin letters and is not inflected: a translated or declined name matches nothing in the interface and nothing in the docs search.
- Старт → Start
- A plan name. The pair is fixed: the Russian name is what the invoice says, the English one is what the interface shows, and an invented third variant matches neither.
- Команда → Team
- A plan name. The pair is fixed: the Russian name is what the invoice says, the English one is what the interface shows, and an invented third variant matches neither.
- Бизнес → Business
- A plan name. The pair is fixed: the Russian name is what the invoice says, the English one is what the interface shows, and an invented third variant matches neither.
- событие → event
- The unit of data you pay for. Not an "action" and not a "hit": both the plan limit and the invoice are counted in events.
- свойство события → event property
- Not a "parameter" and not an "attribute". The tab in the interface matches the field in the API, and this is the word people scan for.
- воронка → funnel
- Plain "funnel", with no adjective: a "sales funnel" is about deals, while this report is a product one and its steps usually stop short of money.
- удержание → retention
- In a Russian answer the report is called «удержание», exactly as the interface labels it. The transliterated form is fine only if the customer used it first.
- рабочее пространство → workspace
- The thing that is paid for as a whole. Plan limits apply to a workspace rather than to a project, and confusing the two answers the customer’s limit question wrongly.
- проект → project
- A separate product with its own key, living inside a workspace. Not a "workspace" and not an "app": the interface treats them as two different levels.
- участник → seat
- Use "seat" when the sentence is about the limit or the bill, because that is what the pricing calls it, and "member" when it is about a person. Mixing them turns "you are out of members" into something faintly menacing.
- ключ проекта → project key
- The public key that sits in the page source. Never call it a token: swap the words and somebody cheerfully posts the wrong one into a public channel.
- токен API → API token
- The secret that can read every project in the workspace. Any answer about it is worth ending with a reminder that it does not belong in a public channel.
- режим только чтения → read-only mode
- What a workspace becomes after an unpaid trial or a failed payment. Not "blocked" and not "deleted": the data is still there, and that is the first thing the person wants to hear.