5 заповедей TypeScript-разработчика

По поводу документирования функции. Если она правильно оформлена с указанием входящих и исходящих типов данных, то она уже является самодокументированной — зачем тратить время на многострочное описание того, что грамотный разработчик прочтет в самой функции?