Пояснительная бригада: иногда в доках пишут полезное

Пояснительная бригада: иногда в доках пишут полезное

Поясняет редакция «Кода»:

На картинке — сцена из сериала «Дом дракона» с Деймоном Таргариеном, который держит в руках свиток и задумчиво-любопытно смотрит на его содержимое. Дальше спойлерить не будем, смотрите сериал.

Сверху картинки — надпись, что после проб и ошибок, которые не сработали, настало время почитать файл readme. И вот здесь как раз надо пояснить.

Файл readme (он же readme.txt, он же read.me) — это послание разработчика к пользователям его продукта. Чаще всего там содержатся инструкции, как работать с программой или сервисом, ответы на частые вопросы или рассказывается, что делать в ситуациях, когда что-то не работает.

👉 В переводе с английского read me означает «прочти меня».

Но разработчики — люди, склонные к энтузиазму и авантюрам, поэтому чаще всего этот файл никто не читает и все сразу начинают пытаться что-то сделать. В большинстве случаев это получается (и поэтому такие файлы не читают). Но вот когда что-то идёт не так, то разработчик сначала перепробует тысячи разных способов и лишь потом, почти сдавшись, откроет readme. Потому что это означает, что он не смог победить глупую машину в равной схватке и приходится пользоваться подсказкой.

С другой стороны, по-настоящему умные и опытные программисты всегда начинают работу с чем-то новым именно с чтения readme. Так, чисто на всякий случай. Вдруг это сэкономит им пару десятков часов бесполезных попыток.

Получите ИТ-профессию
В «Яндекс Практикуме» можно стать разработчиком, тестировщиком, аналитиком и менеджером цифровых продуктов. Первая часть обучения всегда бесплатная, чтобы попробовать и найти то, что вам по душе. Дальше — программы трудоустройства.
А вы читали это?
[anycomment]
Exit mobile version