я бы комментарии ставил после вызова функции, а не в середине, но это вкусовщина, конечно