Разработчики плохо пишут документацию. На словах все говорят «читай инструкцию» (RTFM), а на деле инструкции часто отсутствуют или состоят из разрозненных заметок, устаревших советов и ссылок на пустые форумы, где люди задают одни и те же вопросы снова и снова. Это неправильный способ относиться к пользователям.
Я платил людям, чтобы они следили за моим README
Разработчики часто пишут неудачную документацию. Вместо того чтобы полагаться на самопроверку и инструменты ИИ, один программист решил пригласить реальных пользователей и платить им за тестирование README — и обнаружил множество проблем, которые сам никогда бы не заметил.