Фреймворк Diátaxis выделяет четыре типа документации: туториалы, how-to-гайды, техническая справка и объяснения. Применяется в Gatsby, Cloudflare, Vonage. Лёгкий для внедрения, не накладывает ограничений на реализацию.
В gist от lukewilson2002 предлагают repo-local documentation system — документацию, живущую прямо рядом с кодом и рассчитанную и на людей, и на агентов. Судя по формулировке, автор пытается решить старую проблему: чтобы и новичок не тонул, и LLM не лазила по всему проекту как кот по клавиатуре.
Вышел pre-release ядра 7.1-rc4, и по традиции это не столько про фичи, сколько про уборку за предыдущими неделями. В заметках отдельно выделяют обновления документации по security и AI — потому что даже в kernel world уже успели расплодиться отчёты, дубли и шум. Похоже, список багов живёт своей жизнью, а люди в рассылке больше пересылают ссылки, чем чинят код.
В заметке про kernel prepatch LWN отдельно отмечает, что поток отчётов от AI-инструментов сделал security-список почти неуправляемым. Проблема не в том, что уязвимостей мало — наоборот, их находят слишком много и часто с одинаковыми результатами, из-за чего люди тонут в дублях и пересылках. Хороший пример того, как автоматизация начинает создавать больше очереди, чем пользы.