Google представила Code Wiki — платформу, яка автоматично генерує та оновлює документацію до репозиторіїв, вирішуючи одну з найстаріших проблем розробки: складність читання та розуміння чужого коду. У компанії зазначають, що читання коду є одним із найбільших «вузьких місць» у розробці, оскільки розробники витрачають години, намагаючись розібратися в існуючих модулях до того, як зможуть вносити зміни.
Документація часто застаріває або взагалі не створюється, тому Google пропонує автоматизувати цей процес.
Що робить Code Wiki
Code Wiki сканує кодову базу та формує структуровану вікі-документацію. Коли код змінюється, документація оновлюється автоматично — розробники нічого не редагують вручну.
Платформа інтегрується з Gemini — мовною моделлю Google. Але Gemini тут не виступає загальним чатботом: модель працює виключно на основі актуальної документації та вмісту репозиторію. Це дає змогу ставити запитання про конкретні модулі й отримувати відповіді, прив’язані до реального стану коду.
Кожен розділ вікі містить посилання на відповідні файли, класи й функції. Система генерує архітектурні діаграми, діаграми класів і діаграми послідовностей — і автоматично оновлює їх після кожного коміту.
Публічна прев’ю-версія
Code Wiki доступна в публічному прев’ю для відкритих репозиторіїв на codewiki.google.
Інтерфейс дозволяє інтерактивно переміщатися між документацією та кодом, а Gemini-чат — ставити запитання щодо складних модулів і переходити за посиланнями на вихідний код.
Створювані діаграми не статичні: вони перебудовуються щоразу, коли змінюється архітектура чи логіка програми.
Чому це важливо
Більшість компаній мають код, який ніхто не розуміє повністю — автори вже не працюють або написали цей код багато років тому. Новим учасникам команд потрібно від днів до тижнів, щоб розібратися у великих кодових базах.
Статична документація швидко застаріває: вона не встигає за pull request-ами, а підтримувати її вручну в більшості команд не виходить.
Попередні інструменти автоматичної документації генерували лише API-описи на основі коментарів у коді. Це пояснює функції, але не систему в цілому. Code Wiki робить більше — формує концептуальне уявлення про весь репозиторій і підтримує його актуальність у режимі реального часу.
Що далі
Поки Code Wiki підтримує тільки відкриті репозиторії. Але саме приватні кодові бази — там, де документація найчастіше відсутня — найбільше потребують такого інструмента.
Google працює над розширенням Gemini CLI, яке дозволить запускати Code Wiki локально на внутрішніх репозиторіях без передавання коду стороннім сервісам. Доступ поки недоступний — відкрито список очікування.
Практичні сценарії використання
• Onboarding: нові розробники зможуть швидше зрозуміти систему без тижнів читання коду.
• Оцінка чужих бібліотек: старші інженери отримають швидший спосіб зрозуміти кінцеву архітектуру.
• Legacy maintenance: автоматична актуальна документація знімає тягар ручного опису складних систем.
Google активно розширює інструменти для розробників, що використовують Gemini. Нещодавно компанія анонсувала інтеграцію Google Colab у VS Code. Code Wiki — ще одна спроба застосувати ШІ для реальних задач розробки.
Як платформа працюватиме на складних кодових базах — залежатиме від якості згенерованих пояснень та здатності Gemini відповідати на технічні запитання щодо живого коду.
Google робить ставку на те, що розробники хочуть витрачати менше часу на «декодування» систем і більше — на створення нового функціоналу. Якщо Code Wiki впорається з цим, підхід до документації в індустрії може змінитися.
Публічна прев’ю-версія доступна зараз; команди можуть долучитися до списку очікування для CLI.
Читайте на ProIT: ШІ без багів: Sonar представила інструмент для якісного коду.
Підписуйтеся на ProIT у Telegram, щоб не пропустити жодної публікації!
