Суть в том, что на больших проектов по типу bem yandex, когда есть единые стили оформления для кнопок и прочего - классно иметь html документацию кода (типа bootstap).
Что-то интересное есть -
https://github.com/sourcejs/sourcejs-contrib-dss
Хотелось бы у вас узнать - что подобное для формирования подобной доки вы юзаете в своей работе.