🥸 Постепенный отказ от документирования кода с помощью SassDoc планируется ближе к релизу OmniSass Core 1.0.0.

Причины, по которым стоит отказаться от использования SassDoc, очевидны: избыточный объем информации и "мусор" в коде, ограничения, связанные с SassDoc, сложность конфигурации и разработки собственной темы, а также отсутствие возможности масштабирования.

Часто на написание документации с помощью SassDoc уходит больше времени, чем на создание самого кода функции или миксина. Я бы предпочел заниматься этим после завершения работы над функционалом, непосредственно перед релизом.

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

Сроки на данный момент неизвестны.

🎮 Исходный код на платформе @SourceCraft 🔗 Дубляж новостей также доступен в канале VK.

#news@omnisass