Если вы когда-нибудь пытались прочитать код, написанный кем-то, кроме вас (у кого нет?), Вы знаете, что это может быть сложной задачей. Беспорядочный «код спагетти», смешанный с множеством странно названных переменных, заставляет вашу голову кружиться. Эта функция ожидает строку или массив? Эта переменная хранит целое число или объект?
Взято из:
PHPMaster: Введение в PhpDoc