edit docs/content.md

Author: bloodmike

ru/tools/docs/build.md

@@ -26,18 +26,13 @@ yfm -o ./output-folder
 * [проверки условия отображения контента](../../syntax/vars.md#conditions) на страницах документа;
 * [подстановки переменных](../../syntax/vars.md#subtitudes), если указан параметр `apply-presets`;
 * [инлайнинг SVG-изображений](../../syntax/media.md#img-inline);
-* [подстановки заголовков статей вместо {#T}](../../syntax/links.md#autotitle).
+* [подстановки заголовков статей вместо {#T}](../../syntax/links.md#autotitle);
+* [вставки контента из файлов](../../syntax/includes.md).
 
 Используйте этот вид сборки, чтобы поддерживать несколько вариантов документации для разных пользователей. Если в документации есть разделы с внутренней информацией, вы можете держать два репозитория — приватный и публичный, и синхронизировать приватный в публичный с помощью условий.
 
 ## Watch-режим {#watch}
 
-{% note info "Beta-функциональность" %}
-
-При возникновении проблем сообщите об этом с помощью [GitHub issues](https://github.com/diplodoc-platform/cli/issues).
-
-{% endnote %}
-
 Вы можете автоматизировать пересборку отдельных статей при их изменении. Для этого вызовите `yfm build` с параметром `--watch`: после сборки проекта программа перейдёт в режим инкрементальной пересборки и будет создавать или обновлять статьи после сохранения изменений в исходных файлах документации.
 
 Для удобства, после пересборки открытого в браузере файла выполняется автоматическая перезагрузка страницы.

ru/tools/docs/content.md

@@ -1,6 +1,6 @@
 # Сборка одного файла
 
-Команда `yfm content` обрабатывает **один** Markdown-файл и выводит результат в `stdout` (или записывает в файл). В отличие от [`yfm build`](build.md), она не обходит весь проект и не собирает полноценную страницу: для формата `html` выводится только **контентный фрагмент** — без оглавления, шапки и прочей обвязки страницы.
+Команда `yfm content` обрабатывает **один** md-файл и выводит результат в `stdout` (или записывает в файл). В отличие от [`yfm build`](build.md), она не собирает полноценную страницу: для формата `html` выводится только **контент** — без оглавления, шапки и обвязки страницы.
 
 Команда удобна, когда нужно быстро получить предобработанный контент одного файла — например, чтобы передать его в другой инструмент, отрендерить предпросмотр в редакторе или использовать в собственном пайплайне.
 
@@ -20,21 +20,21 @@ yfm content -i ./page.md -f html -o ./page.html
 
 Формат задаётся параметром `--output-format` (`-f`):
 
-* `md` — self-contained Markdown: [вставки](../../project/toc-includes.md) и [автозаголовки](../../syntax/links.md#autotitle) встроены в файл, добавлен frontmatter. По умолчанию для одиночного файла.
-* `html` — только контентный HTML-фрагмент страницы (без оглавления, шапки и обвязки).
+* `md` — предобработанный Markdown. По умолчанию для одиночного файла.
+* `html` — HTML-контент страницы (без оглавления, шапки и обвязки).
 
-При обработке применяются те же преобразования, что и при [сборке YFM → YFM](build.md#yfm): проверки условий видимости, [подстановки переменных](../../syntax/vars.md#subtitudes), инлайнинг SVG и подстановки заголовков.
+При обработке применяются те же преобразования, что и при [сборке YFM → YFM](build.md#yfm): проверка условий видимости, [подстановка переменных](../../syntax/vars.md#subtitudes), [инлайнинг SVG](../../syntax/media.md#img-inline), [вставка заголовков](../../syntax/links.md#autotitle) и [контента из файлов](../../syntax/includes.md).
 
 ## Корень проекта {#project-root}
 
-Пресеты (`presets.yaml`), [вставки](../../syntax/includes.md), ссылки и [переменные](../../syntax/vars.md) резолвятся относительно корня проекта:
+Пресеты (`presets.yaml`), [вставки](../../syntax/includes.md), ссылки и [переменные](../../syntax/vars.md) ищутся относительно корня проекта:
 
 * по умолчанию корнем считается **текущая рабочая директория**;
 * передайте `--config` (`-c`) с путём до `.yfm` — корнем станет директория этого файла.
 
 {% note info %}
 
-Если обрабатываемый файл лежит вне выбранного корня, корнем становится директория самого файла — чтобы вставки и пресеты корректно резолвились.
+Если обрабатываемый файл лежит вне выбранного корня, корнем становится директория самого файла.
 
 {% endnote %}
 
@@ -60,25 +60,19 @@ yfm content -i ./page.md -f html -o ./page.html
 yfm content -i ./page.md -f md --raw > page.md
 ```
 
-При этом диагностика (предупреждения, ошибки) по-прежнему идёт в `stderr`, а код возврата остаётся ненулевым при ошибке — так что `stdout` содержит только валидный контент.
+При этом диагностика (предупреждения, ошибки) по-прежнему идёт в `stderr`, а код возврата остаётся ненулевым при ошибке — так что `stdout` содержит только корректный контент.
 
 Вместе с `-o` флаг `--raw` ничего не меняет: в файл всегда пишется «сырой» контент.
 
 ## Watch-режим {#watch}
 
-{% note info "Beta-функциональность" %}
-
-При возникновении проблем сообщите об этом с помощью [GitHub issues](https://github.com/diplodoc-platform/cli/issues).
-
-{% endnote %}
-
 С параметром `--watch` (`-w`) команда отслеживает изменения входного файла, его вставок и пресетов и перерисовывает результат при каждом сохранении.
 
 ## Параметры {#options}
 
 | Параметр                            | По умолчанию | Описание                                                       |
 | ----------------------------------- | ------------ | -------------------------------------------------------------- |
-| `-i, --input <file>`                | —            | Путь до обрабатываемого Markdown-файла (обязательный)          |
+| `-i, --input <file>`                | —            | Путь до обрабатываемого md-файла (обязательный)          |
 | `-o, --output <file>`               | stdout       | Записать результат в файл вместо stdout                        |
 | `-f, --output-format <md \| html>`  | `html`       | Формат вывода                                                  |
 | `--raw`                             | `false`      | Выводить в stdout только контент (без маркеров и баннеров)     |