Денис Паясь

Доклады

26
MoscowJS 26,

JSDoc3 in Depth

Я уверен что все любят писать JSDoc☺ Он вкусный, полезный, помогает нашим IDE находить ошибки, и вообще делает жизнь лучше. Однако с ростом проекта, желания выходят на новый уровень, и хочется чтобы этот JSDoc стал чем то большим – например полноценной документацией. Она должна харниться в вебе, а человек, плохо занкомый с проектом, мог бы быстро зайти на сайт и понять что к чему. В сети есть несколько инструментов, которые могут сгенерировать документацию из JSDoc, но зачастую из коробки результат получается не очень. В моем докладе я расскажу почему именно так происходит, какой именно инструмент стоит выбирать для сложных проектов (спойлер в названии), чему его можно научить, и почему от него можно добиться практически чего угодно.