Пиши в комментариях идеи, которые привели к появлению этого алгоритма. Код останется на долгие годы, а причины выбора именно такого алгоритма — забудутся через месяц, а ты потом ломай голову.
В процессе программирования ты создаешь знания, и большая часть знаний скрыта в коде, который никогда не был написан. На каждый успешно созданный метод приходится в десять раз больше идей и попыток написать другой, пусть даже мысленно. Код — это запись о решении "да". А где знания о решениях "нет", которых намного больше?
Эти знания очень ценны, сохрани их. Просто напиши прямо здесь и сейчас, как есть. Как можно проще и быстрее, неважно в какой строке и в каком формате. Самое главное — выгрузи знания, а уже переписывать будешь потом, если вообще захочешь.
Не бывает слишком много комментариев в коде.
// no need to sign pdf url
// as we don't let users download it
async function signUrls({ s3, expirationSeconds = 3600, fileHelper }) { }