мне кажется, что гарантия контракта - это очень много

у всего есть цена и не все так однозначно, как может показаться

ты прикинь: смотришь на функцию и точно понимаешь, что она вернет, и что ей надо на вход

а код функции - просто свернут в редакторе

а оно тебе надо? ты ведь ушел из проекта! тебе за это будут платить снова?

export interface ChFiche {
  id?: string;
  title?: TranslatedString;
  description?: TranslatedString;
  occupations: Occupation[];
  competences: Competence[];
  prerequisiteIds: string[];
  softskillIds: string[];
  workEnvironmentIds: string[];
}

function transformFiche(fiche: ChFiche){}

вызвать подсказку в шторме

Только два вариант: либо пишут поддерживаемый и нормальный код, либо постоянно ковыряются в лапше.
Типы ничего не решают. Лапшу можно и на тс написать, как и чистый код на ваниле

можно написать чистый код на ваниле без jsdoc’овых типов?

конечно, а разве есть сомнения?
Сколько больших проектов написано на JS (дохера), и сколько из них покрыты типами (крайне немного)?

ну вот пример. Я в тупике, как тут без хотя бы jsdoc’а

при этом пример не какой-то особенный, в большинстве CRUD’ов будет такая же беда

> Все шибко умные и не ошибаются?
нет
> Мирятся с багами?
да.. и фиксятся по мере появления буфера в спринте
> 100% тест-коверадж?
нет.. у нас он ниже 0.6%
> еще что-то?
писать нормальный читабельный код и писать комментарии почему оно так работает. особенно в частях которые ты сам не понимаешь (или не смодешь понимать через неделю, если забыть про этот участок кода,,,, на такой вариант надо смотреть всегда, когда пишешь код)


жсДок/интерфейсы и прочее это только верхушка айсберга.. про коментарии не надо забывать.. про названия переменных, констант, функции, а так же про саму архитектуру в проекте/либе/файле/итд

причем тут чистый код и jsDoc? это разные вещи

у меня вот к комментариям такие же претензии как у Роберта Мартина

который Clean Code

если ты написал комментарий, скорее всего, что-то не так, тебе срочно надо сделать этот комментарий ненужным

скорее всего - что-то переименовать или где-то ввести дополнительных функций

в 99,9% случаев - ошибочное решение!

ну вот гляди. Комментарий - это всего лишь текст, и когда ты его пишешь, у тебя вместо одного места, в котором описана логика (в КОДЕ) появляется два места (в коде и в комментарии). Через полгодика развития проекта комментарий начинает врать - потому что код поменяли, а комментарий - забыли/забили/не поняли/не посчитали нужным поменять.

да собственно, что я распинаюсь, Clean Code, глава 4