Можно ли в пользовательские функции запихивать описания этих же функций? Не будет ли это дурным тоном?
А это тогда для чего?
https://ru.wikipedia.org/wiki/PHPDoc
Для этого существуют комментарии и стандарты комментирования PHP-кода, которые поддерживают многие IDE. И да, это будет дурным тоном.