Комменты, о которых я упомянул, это не те комменты, где объясняется, какой Вася его написал и почему так написал и т.д
Краткое описание, класса/метода
Его параметры и типы, что возвращает и т.д (особенно если нету тайпскрипта)
Про читать код, согласен, но это придет с опытом всё равно, а вот документировать свой код, может так и не прийти (ИМХО, исходя из своего опыта, рылся в говне, особенно когда кодовая база огромная где нету комментов, это жесть)
Оставлю ссылочку ещё раз, на заметку так сказать, для хулиганов, которые не документируют свой код
https://jsdoc.app/