A
дока не может быть муудреной
Size: a a a
2019 June 19
НН
Я в курсе, спасибо, но не соглашусь с вами
НН
Мы далаем проект, я прошу девелоперв, плиз, внедрите этот js файлик (с маркдипом) и всё, вуа-ля, всё красиво пишется и рендрится, девы довольны, юзеры довольны
A
а зачем им быть совместимыми друг с другом, если юзер или дев её смотрит. я не считаю это минусом
переход с одного на другой при необходимости может быть крайне болезненный
НН
Это очень, очень узкий юзкейс, Для которого есть https://babelmark.github.io
OI
@Nick_Volynkin @LittleSunnyboy по хорошему, если смотреть правде в глаза, то и markdown ни хрена не панацея от всех болезней.
У него есть разрушительные преимущества перед тем же Word и прочими текстовыми процессорами где ты больше занимаешься форматированием, чем писанием. Такой переход принесет много облегчения и радости от простоты его использования, ввиду незамысловатого синтаксиса.
Но, чем дольше и разнообразнее ты используешь markdown, тем четче ты понимаешь, насколько он конченный, ограниченный и вообще, годится только для сраных ридми в гитхабе.
Для более-менее серьезного технического писательства он не подходит. От слова вообще
У него есть разрушительные преимущества перед тем же Word и прочими текстовыми процессорами где ты больше занимаешься форматированием, чем писанием. Такой переход принесет много облегчения и радости от простоты его использования, ввиду незамысловатого синтаксиса.
Но, чем дольше и разнообразнее ты используешь markdown, тем четче ты понимаешь, насколько он конченный, ограниченный и вообще, годится только для сраных ридми в гитхабе.
Для более-менее серьезного технического писательства он не подходит. От слова вообще
Я использую rst
A
Я использую rst
супер! А я всерьез думаю мигрировать на asciidoc
A
Это очень, очень узкий юзкейс, Для которого есть https://babelmark.github.io
точно так, что же как babel для es6.
НН
Есть может под рукой у вас репы по awesome rst и такое же по asciidoc, я бы с радостью полистал репы для общего развития
A
суть же не в этом
A
после asciidoc на маркдаун даже смотреть не хочется
NV
Ооо, а как собираете комментарии и правки? Edit this page?
Пулл-реквесты
НН
после asciidoc на маркдаун даже смотреть не хочется
Верю, но я наверное слишком фанат md уже, чтобы слезать, может как-нить потом, если упрусь в потолок возможностей
A
Пулл-реквесты
для обычного читателя это overhead.
A
Верю, но я наверное слишком фанат md уже, чтобы слезать, может как-нить потом, если упрусь в потолок возможностей
ну, наверное да. Просто я уже уперся и меня реально это выбешивает. Пока используется простая структура документации и нет сложных текстов, маркдаун еще не трещит по швам
A
по ощущениям мне маркдаун напоминает shortcodes в темах wordpress. Вроде и удобная приблуда, но, когда ты понимаешь, что есть что-то лучше и красивее, потом думаешь о том, сколько нужно усилий, чтобы смигрировать, потом машешь на это рукой
НН
Из доки аскидоктора увидел такую прОклятую штуку — https://opalrb.com
НН
Круто, что оно прям работает
NV
для обычного читателя это overhead.
Вот тогда пушить в Гугл-доки и там пусть комментируют