Полезно указывать тип данных, возвращаемых функцией

Для простых типов можно указывать результат одним словом:

getPublishersCount()
generateHtmlTemplateString()

Для более сложных случаев стоит дать название структуре данных, которую возвращает метод или функция. В C/C++ без названия особо-то и не получится, а вот в чистом JS нет механизма определения типов данных. Поэтому я пишу определение структуры в синтаксисе TypeScript, не используя при этом сам TypeScript:

/*
interface JobRecord {
  id: number;
  name: string;
  path: string;
  isActive?: boolean;
}
*/

getJobRecordById(jobId) {
}

getUserInstance() {
}

getStatsByUserIdByDate(userId) {
}

Можно не описывать тип данных для методов, которые возвращают записи из базы данных — будем считать, что здесь все очевидно:

getUserRecord() {
}

И еще. Я считаю вредным указывать именно тип данных в названии. Когда метод называется getPublishersCount(), словечко Int в нем не добавит ясности.