RG
Md сильно проще.
Николай, рекомендуешь не мучать команду и не требовать asciidoc?
Size: a a a
2020 February 18
NV
Николай, рекомендуешь не мучать команду и не требовать asciidoc?
Это команда разработчиков или писателей?
RG
Это команда разработчиков или писателей?
Трое системных аналитиков, архитектор, техпис, бизнесаналитик
NV
У нас писатели осознанно выбрали reST, потому что он мощнее и на наших масштабах он берёт на себя очень многое. Например, проверяет синтаксис и целостность ссылок.
NV
То есть у нас были реальные проблемы, которые reST решает, а Md не решил бы. Соответственно, и у вас должны быть такие проблемы, которые решатся только AsciiDoc'ом, но не Md. Иначе я не знаю, как убедить людей использовать более сложный инструмент )
RG
То есть у нас были реальные проблемы, которые reST решает, а Md не решил бы. Соответственно, и у вас должны быть такие проблемы, которые решатся только AsciiDoc'ом, но не Md. Иначе я не знаю, как убедить людей использовать более сложный инструмент )
Просто лично мне asciidoc никогда не казался сложнее, поэтому я и задаю тут эти вопросы. Удивлён противодействием команды. Я приводил доводы, головой кивают, а документы продолжают слать в доке
ML
У нас писатели осознанно выбрали reST, потому что он мощнее и на наших масштабах он берёт на себя очень многое. Например, проверяет синтаксис и целостность ссылок.
о, прикольно. Я для markdown сам писал валидатор ссылок
I
У меня первая работа в айти была в команде где любили с rst, и он мне казался убогим после latex :D
ML
У меня первая работа в айти была в команде где любили с rst, и он мне казался убогим после latex :D
Тссс
iv
У меня первая работа в айти была в команде где любили с rst, и он мне казался убогим после latex :D
ну вообще говоря, у latex своя специфическая сфера применения, а именно подготовка печатных форм (typesetting)
СФ
по нашему опыту на удивление много команд разработки документируют именно в latex
iv
и latex это не только язык разметки, но и конкретный инструмент, который выдаёт device independent результат
СФ
потому что (а) академический бэкграунд (все щупали latex в университете) и (б) неведение о существовании других инструментов
NV
по нашему опыту на удивление много команд разработки документируют именно в latex
Прямо сразу в нём пишут отдельные документы?
iv
по нашему опыту на удивление много команд разработки документируют именно в latex
если они получают из него не pdf, готовый к печати, то выглядит как из пушки по воробьям
СФ
Прямо сразу в нём пишут отдельные документы?
да
СФ
если они получают из него не pdf, готовый к печати, то выглядит как из пушки по воробьям
только PDF и получают
NV
Я знаю человека, который сразу в groff пишет. Это формат manpages, если что.
ML
ну вообще говоря, у latex своя специфическая сфера применения, а именно подготовка печатных форм (typesetting)
У латеха готовый препроцессор. Вылить из него pdf, html, xml причем с картинками и условной генерацией - это все из коробки. Но его мало кто умеет использовать
I
Мне кажется самый простой способ понять нужен ли тебе rst вместо md это про всякие автогенерации содержания и сложные ветвистые структуры, типа когда один документ куда-то ещё ссылается