Почему современная документация к коду — просто мусор. И как это исправить

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

Почему современная документация к коду — просто мусор. И как это исправить Читать полностью »