Документация устаревает быстрее, чем код успевает писаться? Рассказываем, как мы построили конвейер из Python-скриптов и нейросетей, который сам находит изменения в PHP-контроллерах и обновляет документацию API Invapi. Читать далее
Тебе не нужна школа дизайна, чтобы быть крутым дизайнером (синк абоут ит). Такие организации плодятся, когда люди ленятся получать полное образование, но не ленятся заполучить волшебную таблетку. Так рождаются школы «короткого пути». Короткого пути в никуда. Читать далее
Вы тоже думали, что в Anthropic сидят небожители, которые пишут идеальный код с помощью секретных версий Claude 5.0? Похоже, нет. У них те же проблемы, что и у нас: джуны разучились гуглить, сеньоры ленятся писать документацию, а "холодный старт" проекта вгоняет в ступор даже SotA модели.На…
Что пользователь хочет видеть в пользовательской документации? Что его в ней раздражает? Эти вопросы задаёт себе каждый, кто пишет такую документацию, но далеко не каждый правильно отвечает на них. Совсем небольшой процент пользователей читает документацию. Давайте разберёмся, почему так и как сделать пользовательскую документацию эффективной и изменить отношение пользователей к ней. Читать дальше →