Ответ
Да, регулярно. В моей практике это важная часть работы в команде. Например, на одном из проектов я рецензировал OpenAPI-спецификацию для нового REST API. Я заметил, что в документации не хватало примеров ответов для различных кодов состояния HTTP и описания бизнес-логики для некоторых полей.
Я предложил добавить конкретные примеры и уточнить контракты. Это помогло фронтенд-разработчикам и мобильной команде быстрее и без ошибок начать интеграцию. Также я часто оставляю комментарии к документации в Confluence или README, если нахожу устаревшие инструкции по настройке окружения или запуску тестов.