# Обновленный JSDoc в библиотеках блоков

Привет!

Еще совсем недавно мы разделяли вашу боль, связанную с отображением JSDoc в наших библиотеках, поэтому решили кардинально пересмотреть отображение вкладок Javascript API в наших блоках. 

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

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

Что мы улучшили:
- в каждом блоке появилось содержание, которое, по сути, является ссылками на нужные якори на странице;
- все сущности одного блока теперь выводятся по секциям. Например, отдельно методы блока `button` и отдельно методы его модификатора `_type_link`;
- выводится вся доступная информация по каждому методу: описание, что возвращает метод, какие принимает параметры;
- если блок возвращает класс, то будут доступны методы класса;
- выводится наследование от другого блока в поле `augments`, даже если у блока нет своих публичныx методов;
- напротив методов выводятся метки, если они имеют статус `protected`, `override ` или `abstract`;
- если метод устарел, то в нем появится соответсвующее поле с описанием;
- опциональные параметры выводятся с определенным оформлением `[ ]` и серым цветом.

На данный момент текущий вид мы считаем окончательным, но мы с удовольствием выслушаем ваши пожелания и фидбэк по узким местам, которые мы упустили.
Обратную связь вы можете публиковать [на наш форум](https://ru.bem.info/forum/?labels=asktheteam) в виде постов с меткой `asktheteam`.

Обновленный JSDoc появился в последних версиях библиотек [bem-history](https://ru.bem.info/libs/bem-history/), [bem-components](https://ru.bem.info/libs/bem-components/) и [bem-core](https://ru.bem.info/libs/bem-core/).

Главный результат всей работы — [полноценный референс по всем методам i-bem.js](https://ru.bem.info/libs/bem-core/current/desktop/i-bem/jsdoc/)

Приятного использования и **Stay BEMed!**