NV
Питон ооочень далек от лингвистики. Про R, да и про обучение самому пайтону лингвистов, не скажу. Так как не в курсе.
Главред же на питоне написан )
Size: a a a
2021 January 17
H
Есть в чате пользователи madcap, хэлопов, докторов? Давайте анонимный опрос проведём, пусть укажут зп.
H
Интересно вот это соотношение выяснить.
M
Help and manual закроет почти все потребности и проще всех docs as code. Только берите pro версию.
Если 600уе много, можно и Dr. Eplain.
Если 600уе много, можно и Dr. Eplain.
Проблемы - неудобное ревью и поддержка перевода :( но да, разворачивать сильно проще
ДЧ
Главред же на питоне написан )
+
M
А вот я ещё смотрю:
AsciiDoctor хочет Ruby в окружении
Sphinx - Python
То есть при выборе инструмента документирования мы должны опираться на то, что уже есть у разрабов?
AsciiDoctor хочет Ruby в окружении
Sphinx - Python
То есть при выборе инструмента документирования мы должны опираться на то, что уже есть у разрабов?
NV
А вот я ещё смотрю:
AsciiDoctor хочет Ruby в окружении
Sphinx - Python
То есть при выборе инструмента документирования мы должны опираться на то, что уже есть у разрабов?
AsciiDoctor хочет Ruby в окружении
Sphinx - Python
То есть при выборе инструмента документирования мы должны опираться на то, что уже есть у разрабов?
Я недавно узнал, что у AsciiDoctor есть выбор между Ruby, JS и Java. Какая-то хитрая кроссплатформенная магия )
Подробности тут https://t.me/docops/516
Подробности тут https://t.me/docops/516
F
А вот я ещё смотрю:
AsciiDoctor хочет Ruby в окружении
Sphinx - Python
То есть при выборе инструмента документирования мы должны опираться на то, что уже есть у разрабов?
AsciiDoctor хочет Ruby в окружении
Sphinx - Python
То есть при выборе инструмента документирования мы должны опираться на то, что уже есть у разрабов?
Ruby умирает... если так, то асидока убивать и переписывать следует.
NV
Ruby умирает... если так, то асидока убивать и переписывать следует.
Уже, называется Antora
M
Я недавно узнал, что у AsciiDoctor есть выбор между Ruby, JS и Java. Какая-то хитрая кроссплатформенная магия )
Подробности тут https://t.me/docops/516
Подробности тут https://t.me/docops/516
ой, в этом подкасте такими словами Конфу обложили, что я им не верю. Если что, связка "обновление документации через таски, генерация через плагин Scroll, и всё это на битбакете" закрывает весь этот ваш doc-as-a-code. Но дорого, да, и никто не хочет битбакет :)))
NV
А вот я ещё смотрю:
AsciiDoctor хочет Ruby в окружении
Sphinx - Python
То есть при выборе инструмента документирования мы должны опираться на то, что уже есть у разрабов?
AsciiDoctor хочет Ruby в окружении
Sphinx - Python
То есть при выборе инструмента документирования мы должны опираться на то, что уже есть у разрабов?
Но вообще, необязательно.
— первое время хватит того, что есть из коробки
— для брендирования нужен фронтендер
— и только если очень хочется чего-то необычного, тогда нужен разработчик на том же языке. И то там довольно простой код.
— первое время хватит того, что есть из коробки
— для брендирования нужен фронтендер
— и только если очень хочется чего-то необычного, тогда нужен разработчик на том же языке. И то там довольно простой код.
F
ой, в этом подкасте такими словами Конфу обложили, что я им не верю. Если что, связка "обновление документации через таски, генерация через плагин Scroll, и всё это на битбакете" закрывает весь этот ваш doc-as-a-code. Но дорого, да, и никто не хочет битбакет :)))
По мануалам не скажу, но за требования не тянет ни конфа ни вся вот эта казалось бы экосреда. Даже половину не закрывает. Даже вместе.
M
По мануалам не скажу, но за требования не тянет ни конфа ни вся вот эта казалось бы экосреда. Даже половину не закрывает. Даже вместе.
Гост овские требования не закроет, это да. А остальное... например?
F
Гост овские требования не закроет, это да. А остальное... например?
Я не про требования к документации только, я и про требования к бизнесу, системам, решениям стекходеров, исполнителей, пользователей. Процесс до реализации. А не после реализации.
M
Я не про требования к документации только, я и про требования к бизнесу, системам, решениям стекходеров, исполнителей, пользователей. Процесс до реализации. А не после реализации.
ой. То есть написание требований в маркдауне и ревью через гит кажется более продуктивным для разработки требований, чем веб-хостед интерфейс с перепиской хоть в комментах, хоть инлайн, и с draw.io на борту?
F
ой. То есть написание требований в маркдауне и ревью через гит кажется более продуктивным для разработки требований, чем веб-хостед интерфейс с перепиской хоть в комментах, хоть инлайн, и с draw.io на борту?
Нее, и то и другое вместе не тянет на целостность. Которая нужна мне. Реально. Может я тут конечно хочу слишком много.
NV
ой. То есть написание требований в маркдауне и ревью через гит кажется более продуктивным для разработки требований, чем веб-хостед интерфейс с перепиской хоть в комментах, хоть инлайн, и с draw.io на борту?
Если о фактах говорить, то в компании КУРС выбрали AsciiDoc для требований и, похоже, очень рады. И в Ростелекоме аналогично Markdown + Foliant, о чём Костя Валеев рассказать уже много раз.
M
Если о фактах говорить, то в компании КУРС выбрали AsciiDoc для требований и, похоже, очень рады. И в Ростелекоме аналогично Markdown + Foliant, о чём Костя Валеев рассказать уже много раз.
в последнем случае не "выбрали", а "сделали сами для себя", ага )
F
Если о фактах говорить, то в компании КУРС выбрали AsciiDoc для требований и, похоже, очень рады. И в Ростелекоме аналогично Markdown + Foliant, о чём Костя Валеев рассказать уже много раз.
Знаете, это как с подходом "лучше чем ничего". Но технология готова к большему. Что-то, лучше ничего. Но не то к чему хочется прийдти.
NV
в последнем случае не "выбрали", а "сделали сами для себя", ага )
Markdown выбрали, а Foliant как бы сделали, но там много готовых деталей внутри. В первую очередь, MkDocs и pandoc.