Три всадника doc-покалипсиса

hugo или gatsby + pandoc

Я так понимаю это мне. Спасибо =)

Удваиваю совет

я не в восторге от фолианта, кстати

Docsify для Hugo, Docz для Gatsby

Будем рады обратной связи: https://t.me/foliantdocs

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

На логи в корне, кстати, многие жалуются. Надо это дело как-то подрегулировать в следующих релизах.

В логи, если включен отладочный режим, пишется много всякого, но конкретные расширения себя идентифицируют, типа flt.preprocessors.includes. Вроде бы, проблемы с препроцессорами можно локализовать достаточно быстро. Но, конечно, нужна тренировка, это я со своей колокольни сужу.

Возьмем на заметку написать доку про дебаг, рассмотреть популярные кейсы.

С благодарностью принимаем фидбек, будем совершенствоваться — не сразу, но будем.

Спасибо, ребята. Концепция прикольна, но сыровата для использования на сторонних продовских продуктах.

Gatsby в этом плане практически индустриальный стандарт. Огромная экосистема, контроль и куча возможностей. Единственный минус — нужен головастый джаваскриптизёр

Если брать темплейт а-ля Docz, можно обойтись и без реактёра-джаваскриптёра, mdx пора осиливать и нам

Поднимите ручки, кто использует mdx. Как оно вам? Пора?

Кто ж спорит. Впрочем, у нас в «Ростелеком ИТ» оно в проде крутится-вертится, правда, под нашим неусыпным надзором. )) Будем расти над собой, всякое такое. У нас в приоритете гибкость: мы дарим авторам документации возможность выстрелить себе в ногу самым изощренным способом из самой экзотической позы — если человек точно знает, что ему именно это нужно, мы мешать не будем, только поддержим. Оборачивается сие чуть задранным порогом вхождения, но пилить что-то простое можно начинать без подготовки.

Я вникаю понемногу, но ваще пора походу

Пока ещё фолиант достаточно красноглазый, да :)

до поры, до времени — да, можно обойтись

но когда возникают хитрые задачи (собирать pdf, например), без него не обойтись

Про пдф не начинайте тока, я триггерюсь)

кто ж тексты писать будет, я уже пишу только 20% своего рабочего времени

у всех глаз задёргался