Как правильно комментировать код?
На случай, если еще не читали:
https://www.ozon.ru/context/detail/id/5011068/ 
https://www.ozon.ru/context/detail/id/138437220/
в обоих книгах есть главы про комментирование кода.
А что такое *user info, *user data? В фигурных скобках нужно указывать тип переменной, например, string, number, object или какой-то свой кастомный тип, заданный с помощью `@typedef`. И обычно не пишут "Function for ...", и так понятно, что это функция, достаточно написать, например, Gets a random text message, Creates user message. Или то же самое, но в инфинитиве - Get, Create и т.д.