Когда вы в последний раз сталкивались с качественно документированным кодом?

С кодом, который можно было использовать буквально «из коробки», просто ознакомившись с небольшим README файлом. Но к которому в то же время прилагалась подробная документация, поясняющая каждую строчку: не только то, что она делает, но и почему она была написана именно так, а не иначе.

Давно ли вы встречали такой код? Неделю назад? Месяц? Год?

Лично мне посчастливилось увидеть такой код пару лет назад. И с тех пор я видел немало кода с… довольно грязной документацией.

Но разве можно винить в этом разработчиков?

Читать далее

https://habr.com/ru/post/698712/?utm_source=habrahabr&utm_medium=rss&utm_campaign=698712