Пояснительная бригада: иногда в доках пишут полезное
На картинке — сцена из сериала «Дом дракона» с Деймоном Таргариеном, который держит в руках свиток и задумчиво-любопытно смотрит на его содержимое. Дальше спойлерить не будем, смотрите сериал.
Сверху картинки — надпись, что после проб и ошибок, которые не сработали, настало время почитать файл readme. И вот здесь как раз надо пояснить.
Файл readme (он же readme.txt, он же read.me) — это послание разработчика к пользователям его продукта. Чаще всего там содержатся инструкции, как работать с программой или сервисом, ответы на частые вопросы или рассказывается, что делать в ситуациях, когда что-то не работает.
👉 В переводе с английского read me означает «прочти меня».
Но разработчики — люди, склонные к энтузиазму и авантюрам, поэтому чаще всего этот файл никто не читает и все сразу начинают пытаться что-то сделать. В большинстве случаев это получается (и поэтому такие файлы не читают). Но вот когда что-то идёт не так, то разработчик сначала перепробует тысячи разных способов и лишь потом, почти сдавшись, откроет readme. Потому что это означает, что он не смог победить глупую машину в равной схватке и приходится пользоваться подсказкой.
С другой стороны, по-настоящему умные и опытные программисты всегда начинают работу с чем-то новым именно с чтения readme. Так, чисто на всякий случай. Вдруг это сэкономит им пару десятков часов бесполезных попыток.