UfoStation

Читайте код вместо документации

Изображение: Читайте код вместо документации

Интересная вырезка с одного из стримов tsoding. Ниже перевод на русский:

Как ты так бесперебойно и плавно программируешь? Читаешь (прежде) много документации?

Нет, на самом деле я практически не читаю документацию, я читаю исходный код. Так что в этом вся разница. Я читаю код, и фактически код это и есть лучшая документация. Знаете почему? Потому что он никогда не станет устаревшим, так? И вы знаете почему он никогда не станет устаревшим?

Потому что, если он устареет, то он больше перестанет быть компилируемым, вы будете вынуждены обновить его, и именно поэтому вы будете в курсе последних изменений.

Я не шучу, это буквально и есть причина, по которой я это делаю. Проблема с документацией в том, что вы меняете код, но забываете изменить документацию, потому что нет стимула этого делать. С кодом такой стимул всегда: вы хотите, чтобы ваш код компилировался. Если он устарел, то он никогда не будет компилироваться, так что это бесполезно.. Хм, поэтому я предлагаю читать код вместо документации.

PS. После этого ответа tsoding открыл страницу документации :)

Нашли ошибку или опечатку? Предложите исправление