Google тихо выкатил вещь, которая выглядит как один из самых полезных инструментов для разработчиков за последнее время. Называется Code Wiki. Суть простая: заходишь на codewiki.google (да, у Google есть свой домен 1-го уровня), кидаешь ссылку на репозиторий — и через пару минут получаешь аккуратную, структурированную документацию. Нормальные схемы, диаграммы, объяснение архитектуры, ключевые файлы, зависимости, маршруты. Всё то, что обычно существует в виде устных легенд, устаревших README или заметок в Confluence, которые никто не обновляет. Меня это зацепило ещё и потому, что история тут повторяется. Полвека назад IBM делала OS/360 — огромную операционную систему, которую писали сотни человек. И у Брукса основной вывод был в том, что самая тяжёлая часть не в самом коде, а в том, чтобы команда одинаково понимала архитектуру. Документация была несущей конструкцией проекта. Без неё система просто бы не собралась. И сейчас мы возвращаемся примерно к тому же: код — это только половина. Вторая половина — понимание. И Code Wiki закрывает вот этот самый слой понимания. Там есть встроенный чат с Gemini, который не просто читает функции, а объясняет архитектуру, связи, намерения, спорные места, точки, где код может развалиться. Можно спросить, почему модуль реализован именно так, где формируется конфиг, какие файлы трогаются при изменении бизнес-логики. Для онбординга, ревью и регресса это просто подарок. Но есть нюанс, который я тоже не могу не отметить. Если смотреть на картину трезво, то такая система даёт Гуглу огромный поток живого, реального кода. Не учебных примеров, не синтетики, а настоящих рабочих репозиториев. Возможно, моя настороженность преувеличена, но когда ты загружаешь весь проект в сервис, принадлежащий ИТ-гиганту, то надо понимать: Gemini становится умнее. Он учится на реальных архитектурах, на реальных ошибках, на реальных паттернах, и в итоге его способность писать код будет расти быстрее, чем у систем, которые видят только открытый опенсорс. Инструмент, который облегчает жизнь разработчикам, одновременно создаёт мощный поток данных, который прокачивает модель. Наверное. А может быть и не обучается. Кто же знает наверняка. При этом сам инструмент ощущается как правильный шаг. Мы приходим к новому стандарту: документация должна быть живой. Она должна обновляться с кодом, быть понятной не только разработчикам, но и менеджерам, аналитикам, тестировщикам. Чтобы человек открыл проект и за пять минут понял, куда смотреть. Это ещё не революция, но движение в ту сторону, о которой IBM мечтала в эпоху OS/360: единая картина, прозрачная архитектура, синхронизированное понимание. Только сейчас это делается не вручную, а одним кликом. ❤️ Лайки продвигают блог 👁 Просмотры вдохновляют писать 💸 Донаты помогают делать новые переводы 📖 Все тексты - на igorkolosov.ru