Алибек Кулсеитов: Это уже сами решайте, что там показывать.
Скажу лишь, что документация большому проекту необходима. Через полгода скажут сделать новый блок на сайте. Посмотришь в доке - возможно уже есть нужный или похожий.
В больших проектах имеет смысл дополнительно делать ui kit - несколько страниц со всеми элементами и базовыми блоками из которых собираются страницы. Здесь же приводить примеры использования. Что-то вроде документации к проекту. В качестве примера можете посмотреть доку к любому css фреймворку.
Пора освоить препроцессоры и системы сборки.
Пора начинать верстать независимыми блоками.
Каждый блок описывать в отдельном файле, включая медиазапросы для него.
А сборку уже настроить как вам угодно - хоть в один файл слить, хоть по нескольким группам раскидать. В любом случае все это легко будет изменить.
Сейчас наметилась тендеция отказа от использования префиксов для тестирования новых фич. Вместо этого новые свойства прячутся под флагом experimental и после того, как полностью готовы - включаются по дефолту сразу без всяких префиксов. Пока еще остаются старые фичи, для которых все еще требуются префиксы, но, например те же гриды появились сразу без префиксов в 4-х браузерах.
