Просто есть документация, описывающая то, "что функция делает" и то, "как именно она это делает". Типизированное объявление функции даёт мне первую документацию: я понимаю, как эта функция взаимодействует с окружающей средой. Разумеется, очень часто мы пишем и вторую документацию, описывающую особенность внутренней работы этой функции.