Skip to content

Sync ru

Anton Sovetov edited this page Nov 8, 2026 · 2 revisions

English · Русский

Вики должна оставаться правдивой

Вики — это вид на код, а не второй источник правды. Каждое утверждение на ней есть и в репозитории, и изменение поведения правит оба места в одном коммите.

Страница Источник правды
Home README.ru.md
Начало работы README.ru.md, internal/cli
Настройка харнесса docs/harness-setup.md
Протокол docs/protocol.md
Автономия docs/protocol.md
Если не работает починенное, каждая запись со своей версией
Заметки о решениях docs/CONTEXT.md

Страницы лежат в docs/wiki/ в репозитории, поэтому изменение в них можно отревьюить в пулл-реквесте, как любое другое. Публикация — один пуш в репозиторий вики; команды — в docs/wiki/README.md.

Зачем эта страница

Вики, которая расходится с кодом, хуже, чем никакой вики: это второй ответ, и неправильный. Правило, которое держит её честной, — то же, что и у кода: каждое утверждение должно быть верно для бинарника.

Языки

Английская страница — основная, русская — её перевод. Имя русской страницы это имя английской плюс -ru: Protocol и Protocol-ru. Переключатель языка стоит первой строкой на каждой странице, поэтому страницу всегда можно найти на другом языке.

При правке меняйте обе версии в одном коммите. Если перевод отстал, лучше удалить устаревшее утверждение, чем оставить его в одном языке и убрать в другом.

Clone this wiki locally