docs(readme): корневой README пересобран по четырем блокам #217

Merged
ddmitry merged 1 commits from 216-readme-rebuild into main 2026-09-02 22:44:56 +03:00
Owner

Closes #216

Корневой README пересобран по раскладке резолюции #211: промо-цитата, «куда я попал», типовые действия, ссылки. По решению владельца в ходе работы «Быстрый старт» сжат до двух команд (cp .env.example .env, make up): проверки — инструмент роботов, в README осталась одна ссылка на карту проверок.

Что изменилось

  • README: промо со ссылкой на https://de.dementev.space и ментора; нейтральная адресация («вы», без слова «менти»); разделы «Адреса и пароли», «Сдвинуть мир вперед», «Вернуть мир к началу», «Выключить или сбросить целиком», «Подключиться из DBeaver» (HTTP-порт 28123, пользователь analyst); «Документация» называет семь справочников вложенным списком. Умерли «Статус», «Что здесь будет», «Чем отличается от предшественника» и три заголовка-якоря.
  • docs/architecture/world.md: устаревшая фраза о «даге этапа 5» заменена (хвост #212 и #214).
  • docs/architecture/stand.md, docs/adr/0007-clickhouse-access.md: ссылки на раздел README «Состав и доступ» переведены на «Адреса и пароли».
  • docs/handbook/README.md: снято слово «менти» в аннотации главы о генераторе.

Проверка

  • Скрипт ссылок из #212 пуст, grep «менти» пуст, make config-test зеленый.
  • Саморевью Sol: 1/1. Слепое ревью Opus: 0 блокеров, 2 minor, 3 nit — закрыты. Вычитка прозы (ai-text-lint + литературный русский): 15 находок, 9 внесены, 6 отклонены как формулировки владельца из образца и резолюции #211 и как термин «явная пересборка».
Closes #216 Корневой README пересобран по раскладке резолюции #211: промо-цитата, «куда я попал», типовые действия, ссылки. По решению владельца в ходе работы «Быстрый старт» сжат до двух команд (`cp .env.example .env`, `make up`): проверки — инструмент роботов, в README осталась одна ссылка на карту проверок. **Что изменилось** - README: промо со ссылкой на https://de.dementev.space и ментора; нейтральная адресация («вы», без слова «менти»); разделы «Адреса и пароли», «Сдвинуть мир вперед», «Вернуть мир к началу», «Выключить или сбросить целиком», «Подключиться из DBeaver» (HTTP-порт 28123, пользователь `analyst`); «Документация» называет семь справочников вложенным списком. Умерли «Статус», «Что здесь будет», «Чем отличается от предшественника» и три заголовка-якоря. - `docs/architecture/world.md`: устаревшая фраза о «даге этапа 5» заменена (хвост #212 и #214). - `docs/architecture/stand.md`, `docs/adr/0007-clickhouse-access.md`: ссылки на раздел README «Состав и доступ» переведены на «Адреса и пароли». - `docs/handbook/README.md`: снято слово «менти» в аннотации главы о генераторе. **Проверка** - Скрипт ссылок из #212 пуст, `grep «менти»` пуст, `make config-test` зеленый. - Саморевью Sol: 1/1. Слепое ревью Opus: 0 блокеров, 2 minor, 3 nit — закрыты. Вычитка прозы (ai-text-lint + литературный русский): 15 находок, 9 внесены, 6 отклонены как формулировки владельца из образца и резолюции #211 и как термин «явная пересборка».
ddmitry added 1 commit 2026-09-02 22:37:11 +03:00
Зачем: README был складом сведений, осевших там, где писались. По
раскладке резолюции #211 он становится лицом репозитория: промо-блок,
«куда я попал», типовые действия, ссылки. Слово «менти» уходит из README
и путеводителя, хвосты #212 и #214 закрываются.

Что: промо-цитата со ссылкой на план обучения и ментора; шапка с
нейтральной адресацией и одной фразой о составе и пути данных; «Быстрый
старт» сжат до двух команд по решению владельца — проверки остаются
роботам, в README одна ссылка на карту проверок; разделы «Адреса и
пароли», «Сдвинуть мир вперед», «Вернуть мир к началу», «Выключить или
сбросить целиком», «Подключиться из DBeaver»; «Документация» называет все
семь справочников вложенным списком. Умерли «Статус», «Что здесь будет»,
«Чем отличается от предшественника» и три заголовка-якоря. В world.md
снята устаревшая фраза о «даге этапа 5», stand.md и ADR 0007 ведут на
новый раздел «Адреса и пароли», в путеводителе снято слово «менти».

Проверка: скрипт ссылок пуст, grep «менти» по README и путеводителю пуст,
make config-test зеленый. Саморевью Sol 1/1; слепое ревью Opus — 0
блокеров, 2 minor, 3 nit, все закрыты; вычитка прозы ai-text-lint и
оптикой литературного русского — 15 находок, 9 внесены, 6 отклонены как
слова владельца и термины.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
ddmitry merged commit 354b8abe56 into main 2026-09-02 22:44:56 +03:00
ddmitry deleted branch 216-readme-rebuild 2026-09-02 22:44:57 +03:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: ddmitry/clickstream-data-platform#217