Здравствуйте, Ikemefula, Вы писали:

I>Например indexOf это хорошее имя, а вот что именно делает функция, что бы найти индекс, совершенно не актуально.

Сдается мне, indexOf точно отражает, что именно делает функция. А вот то, как она это делает, пользователя не интересует. Если же внутри что-то хитро вывернутое, то в начале функции пишем комментарий, содержащий ссылку на документ, описывающий алгоритм, используемый в функции.