Материал сравнивает два подхода к документированию фронтенд-проектов: JSDoc (комментарии в коде) и Storybook (интерактивные сторисы). JSDoc уместен в JS-проектах без TypeScript: позволяет описывать типы и поведение через теги @param, @returns, @example, @typedef, @property, даёт подсказки в IDE и генерирует статическую документацию. Запуск: npm install jsdoc --save-dev, скрипт в package.json: jsdoc index.js -d docs, тонкая настройка через .jsdoc.conf.json. Минусы: рост «шума» в коде, слабая работа со сложными типами, избыточность в TS и необходимость частых актуализаций.

• Storybook: создаёт живую документацию компонентов и их состояний, поддерживает большинство фреймворков. Старт: npm create storybook@latest; запуск: storybook dev -p 6006 -c ./config/storybook. Расширение через webpack-правила (например, SVGR), подключение SCSS, декораторы для темы/Redux/провайдеров.
• Практики: сторисы для страниц (пример BidsPage, BidDetail), мок-стейт Redux, вариации тем, управление пропсами во вкладке Controls, автогенерация раздела документации по тегу autodocs.
• Выбор инструмента: JSDoc — для детальной техдокументации функций и типов; Storybook — для демонстрации UI в разных состояниях и ускорения онбординга.