leemour · Oct 15, 2026 · Oct 15, 2026
diff --git a/content/docs/people.es.md b/content/docs/people.es.md
@@ -32,6 +32,17 @@ Consulta [la misma persona en los dos mensajeros](#link-your-accounts).
 
 <a id="pídeselo-a-tu-agente" />
 
+## Teléfonos y correos en mensajes
+
+Un número de teléfono o una dirección de correo en un mensaje pertenece a alguien, pero las herramientas no adivinan a quién. Cada uno aparece como una mención y tú indicas de quién es. Sustituye `1` por un id de la lista:
+
+```sh
+tg personal mentions list
+tg personal mentions confirm 1 person:7
+```
+
+`mentions confirm` registra que el valor pertenece a la persona (o a una organización con `organization:`). Después, `contacts timeline` y búsquedas como `mentions:"person:7"` incluyen esos mensajes. Un valor equivocado se descarta con `mentions reject`. Más: [Teléfonos, enlaces y nombres](./mentions.md) y [Cómo se vincula todo](./how-things-are-linked.md#menciones).
+
 ## Pide al agente
 
 ```text prompt

diff --git a/content/docs/people.md b/content/docs/people.md
@@ -31,6 +31,17 @@ until you **link** them: you record on your computer that both accounts belong t
 an overview of what they wrote includes their messages from both messengers. See
 [the same person in both messengers](#link-your-accounts).
 
+## Phones and emails in messages
+
+A phone number or an email address in a message belongs to someone, but the tools do not guess who. They list each one as a mention, and you say whose it is. Replace `1` with an id from the list:
+
+```sh
+tg personal mentions list
+tg personal mentions confirm 1 person:7
+```
+
+`mentions confirm` records that the value belongs to the person (or to an organization with `organization:`). After that, `contacts timeline` and searches such as `mentions:"person:7"` include those messages. A wrong value can be dismissed with `mentions reject`. More: [Phones, links and names](./mentions.md) and [How things are linked](./how-things-are-linked.md#mentions).
+
 ## Ask your agent
 
 ```text prompt

diff --git a/content/docs/people.ru.md b/content/docs/people.ru.md
@@ -31,6 +31,17 @@ description: "Вспомните, кто вам написал и что вы о
 человеку. После этого обзор того, что он писал, включит его сообщения из обоих мессенджеров.
 Подробнее — в разделе [один человек в двух мессенджерах](#link-your-accounts).
 
+## Телефоны и почта в сообщениях
+
+Телефон или адрес почты в сообщении кому-то принадлежит, но инструменты не угадывают кому. Они показывают каждое значение как упоминание, а вы говорите, чьё оно. Замените `1` на id из списка:
+
+```sh
+tg personal mentions list
+tg personal mentions confirm 1 person:7
+```
+
+`mentions confirm` записывает, что значение принадлежит человеку (или организации через `organization:`). После этого `contacts timeline` и поиск вроде `mentions:"person:7"` включают эти сообщения. Ошибочное значение отклоняется командой `mentions reject`. Подробнее: [Телефоны, ссылки и имена](./mentions.md) и [Как всё связано](./how-things-are-linked.md#упоминания).
+
 ## Попросите агента
 
 ```text prompt

diff --git a/content/docs/search-architecture.es.mdx b/content/docs/search-architecture.es.mdx
@@ -9,11 +9,7 @@ Comprende por qué una búsqueda encuentra un resultado o lo omite: qué se inde
 
 ### Qué se puede buscar y conectar
 
-| Contenido | Datos que se pueden buscar | Conexión con la fuente |
-| --- | --- | --- |
-| Mensajes y correo | Texto guardado, remitente, chat, fechas y metadatos de adjuntos | Una referencia identifica el proveedor, la cuenta y el mensaje |
-| Notas | Texto guardado, títulos y filtros compatibles | Una referencia de nota; los enlaces guardados pueden conectarla con otros registros |
-| Archivos y transcripciones de reuniones | Texto extraído o aportado, una vez guardado | El texto del adjunto sigue vinculado al mensaje; una transcripción guardada como nota se busca como nota |
+Se pueden buscar mensajes, correo, notas, archivos y transcripciones de reuniones, y cada resultado conserva una referencia a su fuente. Qué registros se conectan con cuáles y quién crea cada enlace está en [Cómo se vincula todo](./how-things-are-linked.md).
 
 `search all` consulta mensajes y notas en `tg` y `max`, y mensajes, correo y notas en `memo`, y combina sus listas ordenadas. Informa de las fuentes omitidas; no convierte todos los tipos de contenido en un único índice de mensajes. Los archivos necesitan extracción de texto y las grabaciones necesitan transcripción antes de buscar su contenido.
 

diff --git a/content/docs/search-architecture.mdx b/content/docs/search-architecture.mdx
@@ -9,11 +9,7 @@ Understand why a search finds a result or misses it: what gets indexed, how matc
 
 ### What can be searched and connected
 
-| Content | Searchable data | Connection to the source |
-| --- | --- | --- |
-| Messages and email | Saved text, sender, chat, dates and attachment metadata | A reference identifies the provider, account and message |
-| Notes | Saved note text, titles and supported filters | A note reference; stored links can connect notes to other records |
-| Files and meeting transcripts | Extracted or supplied text, once saved | Attachment text stays linked to its message; a transcript saved as a note is searched as a note |
+Messages, email, notes, files and meeting transcripts are searchable, and each result keeps a reference to its source. Which records connect to which, and who creates each link, is on [How things are linked](./how-things-are-linked.md).
 
 `search all` queries messages and notes in `tg` and `max`, and messages, email and notes in `memo`, then merges their ranked lists. It reports sources it skipped; it does not turn every content type into one message index. Files need text extraction, and recordings need transcription before their contents can be searched.
 

diff --git a/content/docs/search-architecture.ru.mdx b/content/docs/search-architecture.ru.mdx
@@ -9,11 +9,7 @@ description: "Техническая сторона поиска: сохранё
 
 ### Что можно искать и связывать
 
-| Данные | Что доступно для поиска | Связь с источником |
-| --- | --- | --- |
-| Сообщения и почта | Сохранённый текст, отправитель, чат, даты и метаданные вложений | Адрес указывает провайдера, аккаунт и сообщение |
-| Заметки | Сохранённый текст, заголовки и поддерживаемые фильтры | Адрес заметки; сохранённые ссылки могут связывать её с другими записями |
-| Файлы и расшифровки встреч | Извлечённый или предоставленный текст после сохранения | Текст вложения связан с сообщением; расшифровка, сохранённая как заметка, ищется среди заметок |
+Искать можно сообщения, почту, заметки, файлы и расшифровки встреч, и каждый результат хранит адрес своего источника. Какие записи с какими связаны и кто создаёт каждую связь, описано в [Как всё связано](./how-things-are-linked.md).
 
 `search all` ищет в сообщениях и заметках в `tg` и `max`, а в `memo` — ещё и в почте, затем объединяет упорядоченные списки. Он сообщает о пропущенных источниках, а не превращает все данные в один индекс сообщений. Чтобы искать содержимое файлов, сначала нужно извлечь текст; записи нужно расшифровать.
 

diff --git a/content/docs/search.es.md b/content/docs/search.es.md
@@ -120,12 +120,7 @@ También puedes filtrar por persona, fecha o adjuntos. Las guías de
 
 ## Qué búsqueda elegir
 
-- **Recuerdas palabras:** busca mensajes, el primer paso más sencillo.
-- **Recuerdas el tema:** busca discusiones por significado.
-- **Encontraste un mensaje:** lee el contexto o conversación.
-- **Quieres un recuento:** usa estadísticas en vez de leer cada resultado.
-
-[Búsqueda por temas de Telegram](./tg/topic-search.md) · [MAX](./max/topic-search.md)
+Palabras, un tema, una persona, una imagen, una decisión o un archivo de Drive tienen cada uno su comando: [Busca con eficacia](./search-efficiently.md#elige-el-comando).
 
 ## Si falta un resultado
 
@@ -143,3 +138,10 @@ Usa el [buscador de muestra](./search-playground.mdx) con mensajes integrados. N
 Aprende filtros y operadores en la guía de consultas de [Telegram](./tg/query-language.md) o
 [MAX](./max/query-language.md). [Cómo funciona la búsqueda](./search-architecture.mdx) explica
 la indexación, las conversaciones y el orden de los resultados.
+
+## Páginas de búsqueda
+
+- [Qué se indexa](./what-is-indexed.md): qué se puede encontrar y qué necesita cada tipo de contenido.
+- [Cómo se vincula todo](./how-things-are-linked.md): cómo se conectan mensajes, personas, archivos, notas y tareas.
+- [Busca con eficacia](./search-efficiently.md): elegir el comando, acotar, paginar y reducir la salida.
+- [Prueba la búsqueda de mensajes](./search-playground.mdx): prueba la búsqueda con mensajes incluidos.
diff --git a/content/docs/search.md b/content/docs/search.md
@@ -121,12 +121,7 @@ You can also filter by person, date or attachments. The [Telegram](./tg/search.m
 
 ## Which search should I choose?
 
-- **You remember words:** search messages. It is the quickest starting point.
-- **You remember the subject:** use topic search to find related discussions by meaning.
-- **You already found a message:** ask for its context or conversation to understand the exchange.
-- **You need a count:** use statistics instead of reading every result.
-
-[Telegram topic search](./tg/topic-search.md) · [MAX topic search](./max/topic-search.md)
+Words, a subject, a person, a picture, a decision or a Drive file each have their own command: [Search efficiently](./search-efficiently.md#choose-the-command).
 
 ## If a result is missing
 
@@ -144,3 +139,10 @@ Use the [search playground](./search-playground.mdx) with built-in messages. It
 Learn filters and operators in the [Telegram query guide](./tg/query-language.md) or
 [MAX query guide](./max/query-language.md). [How search works](./search-architecture.mdx)
 explains indexing, conversations and ranking after the practical guides.
+
+## Search pages
+
+- [What gets indexed](./what-is-indexed.md): what can be found and what each kind of content needs.
+- [How things are linked](./how-things-are-linked.md): how messages, people, files, notes and tasks connect.
+- [Search efficiently](./search-efficiently.md): choose the command, narrow, page and trim the output.
+- [Search playground](./search-playground.mdx): try search on built-in messages.
diff --git a/content/docs/search.ru.md b/content/docs/search.ru.md
@@ -121,12 +121,7 @@ max personal search messages 'счёт chat:"Проект"'
 
 ## Какой поиск выбрать?
 
-- **Помните слова:** поиск сообщений — самый простой первый шаг.
-- **Помните тему:** поиск по смыслу находит связанные обсуждения.
-- **Уже нашли сообщение:** прочитайте контекст или весь разговор.
-- **Нужно количество:** используйте статистику вместо чтения каждого результата.
-
-[Поиск по темам Telegram](./tg/topic-search.md) · [MAX](./max/topic-search.md)
+Слова, тема, человек, картинка, решение или файл Drive имеют каждый свою команду: [Ищите эффективно](./search-efficiently.md#выберите-команду).
 
 ## Если результат не найден
 
@@ -143,3 +138,10 @@ max personal search messages 'счёт chat:"Проект"'
 
 Фильтры и операторы — в языке запросов [Telegram](./tg/query-language.md) и [MAX](./max/query-language.md).
 [Как устроен поиск](./search-architecture.mdx) объясняет индексы, разговоры и порядок результатов.
+
+## Страницы о поиске
+
+- [Что попадает в поиск](./what-is-indexed.md): что можно найти и что нужно для каждого вида данных.
+- [Как всё связано](./how-things-are-linked.md): как связаны сообщения, люди, файлы, заметки и задачи.
+- [Ищите эффективно](./search-efficiently.md): выбрать команду, сузить поиск, листать и сократить вывод.
+- [Попробуйте поиск сообщений](./search-playground.mdx): поиск по встроенным сообщениям.
diff --git a/content/docs/what-is-indexed.es.md b/content/docs/what-is-indexed.es.md
@@ -98,7 +98,7 @@ tg personal search messages 'email:"ana@example.com"'
 tg personal search messages 'domain:example.com'
 ```
 
-`phone:` encuentra igual `+1 555 010 0100` y `+1 (555) 010-0100`; sin `+`, solo se reconocen números rusos. `domain:` encuentra todos los enlaces y direcciones de ese sitio. Las menciones se encuentran con reglas, sin modelo. Una mención que rechazas sigue descartada. Cómo revisar menciones y registrar quién es: [Teléfonos, enlaces y nombres](./mentions.md).
+`phone:` encuentra igual `+1 555 010 0100` y `+1 (555) 010-0100`; sin `+`, solo se reconocen números rusos. `domain:` encuentra todos los enlaces y direcciones de ese sitio. Las menciones se encuentran con reglas, sin modelo. Una mención que rechazas sigue descartada. Cómo revisar menciones y registrar quién es: [Teléfonos, enlaces y nombres](./mentions.md). Cómo se conectan las menciones con personas y organizaciones: [Cómo se vincula todo](./how-things-are-linked.md#menciones).
 
 ## Imágenes
 

diff --git a/content/docs/what-is-indexed.md b/content/docs/what-is-indexed.md
@@ -98,7 +98,7 @@ tg personal search messages 'email:"ana@example.com"'
 tg personal search messages 'domain:example.com'
 ```
 
-`phone:` finds `+1 555 010 0100` and `+1 (555) 010-0100` alike; without the `+`, only Russian numbers are recognized. `domain:` finds every link and address on that site. Mentions are found by rules, not by a model. A mention you reject stays dismissed. How to review mentions and record who they are: [Phones, links and names](./mentions.md).
+`phone:` finds `+1 555 010 0100` and `+1 (555) 010-0100` alike; without the `+`, only Russian numbers are recognized. `domain:` finds every link and address on that site. Mentions are found by rules, not by a model. A mention you reject stays dismissed. How to review mentions and record who they are: [Phones, links and names](./mentions.md). How mentions connect to people and organizations: [How things are linked](./how-things-are-linked.md#mentions).
 
 ## Pictures
 

diff --git a/content/docs/what-is-indexed.ru.md b/content/docs/what-is-indexed.ru.md
@@ -98,7 +98,7 @@ tg personal search messages 'email:"ana@example.com"'
 tg personal search messages 'domain:example.com'
 ```
 
-`phone:` находит `+1 555 010 0100` и `+1 (555) 010-0100` одинаково; без `+` распознаются только российские номера. `domain:` находит все ссылки и адреса этого сайта. Упоминания ищутся по правилам, без модели. Отклонённое упоминание остаётся отклонённым. Как разбирать упоминания и отмечать, кто это: [Телефоны, ссылки и имена](./mentions.md).
+`phone:` находит `+1 555 010 0100` и `+1 (555) 010-0100` одинаково; без `+` распознаются только российские номера. `domain:` находит все ссылки и адреса этого сайта. Упоминания ищутся по правилам, без модели. Отклонённое упоминание остаётся отклонённым. Как разбирать упоминания и отмечать, кто это: [Телефоны, ссылки и имена](./mentions.md). Как упоминания связаны с людьми и организациями: [Как всё связано](./how-things-are-linked.md#упоминания).
 
 ## Картинки