Size: a a a

DocOps-сообщество

2020 March 06

FM

Fox Mulder in DocOps-сообщество
есть платный плагин к конфе, который вытягивает мд. Далее этот мд можно засунуть в гит и через питон скрипт настроить автоматический чек и пуш
источник

V

Vanderhoof in DocOps-сообщество
Мы так и сделали сначала, но это всё работало ужасно: там очень урезанный маркдаун; дополнительные проблемы с иллюстрациями (их тоже придётся как-то прикреплять к страничке скриптом и обновлять, подменять пути); комментарии перетираются при каждой новой загрузке.

Это если мы об одном и том же плагине говорим, конечно.
источник

СФ

Семён Факторович in DocOps-сообщество
Igor
Их уже пробовали, не подходит.

Мне нужны комменты к уже опубликованным материалам, а не к pr/mr

Плюс надо не пугать людей страшным программистским жаргоном
возможно, я не очень понимаю проблему, которую вы решаете, но вам точно не подойдет вариант «рендерим из md docx, комментим его как хотим, после окончания комментирования вносим изменения в исходный md»?
источник

I

Igor in DocOps-сообщество
В принципе да, но в моей вымышленной вселенной вот это вот "комментим как хотим" должно быть в интернетах в браузере по ссылочке
источник

СФ

Семён Факторович in DocOps-сообщество
наверное, можно написать какой-нибудь полуавтоматический конвертер-аплоадер docx в Google Docs
источник

I

Igor in DocOps-сообщество
Fox Mulder
есть платный плагин к конфе, который вытягивает мд. Далее этот мд можно засунуть в гит и через питон скрипт настроить автоматический чек и пуш
Как называется не подскажете?

На этом проекте конфлю конечно тоже нет, но на будущее
источник

FM

Fox Mulder in DocOps-сообщество
я не помню уже
источник

I

Igor in DocOps-сообщество
Семён Факторович
наверное, можно написать какой-нибудь полуавтоматический конвертер-аплоадер docx в Google Docs
Ага, это как запасной вариант рассматриваю
источник
2020 March 10

NK

ID:0 in DocOps-сообщество
Оказывается, топология документации, про которую я писал в прошлом посте, взята из статьи Daniele Procida What nobody tells you about documentation.

Есть и видео доклада по этой теме: https://www.youtube.com/watch?v=t4vKPhjcMZg
источник

AB

Anatoly Burnashev in DocOps-сообщество
> Оказывается, топология документации, про которую я писал в прошлом посте, взята из статьи Daniele Procida

Да, а он в свою очередь взял идею статьи из документации Django
А там эта классификация отмечена коммитом
https://github.com/django/django/commit/df3d5b1d73699b323aac377dffab039dca26c1e4
Автор коммита - Tim Graham
источник

NV

Nick Volynkin in DocOps-сообщество
Anatoly Burnashev
> Оказывается, топология документации, про которую я писал в прошлом посте, взята из статьи Daniele Procida

Да, а он в свою очередь взял идею статьи из документации Django
А там эта классификация отмечена коммитом
https://github.com/django/django/commit/df3d5b1d73699b323aac377dffab039dca26c1e4
Автор коммита - Tim Graham
«Thanks Daniele Procida for coauthoring»
источник

NV

Nick Volynkin in DocOps-сообщество
Вот так история )
источник

AB

Anatoly Burnashev in DocOps-сообщество
мда, точно, проглядел
источник

NK

ID:0 in DocOps-сообщество
Похоже, что придумали это Daniele Procida и Tim Graham вместе. Вот упоминание аж из 2015 года, документация Django: https://github.com/django/django/commit/df3d5b1d73699b323aac377dffab039dca26c1e4

Спасибо @Aburnashev за подсказку.
источник

ЕР

Екатерина Рудская in DocOps-сообщество
А пост об этом был в прошлом году, в январе. Эта модель великолепно подошла для доработки легаси процедурно-ориентированной доки.
источник

ИЦ

Игорь Цупко in DocOps-сообщество
Коллеги, а поделитесь гайдами по настройке headless cms в связке с github?
источник

AY

Andrei Yemelianov in DocOps-сообщество
мне нужна ещё одна консультация от знатоков Help&Manual
источник

AR

Anna Ryutina in DocOps-сообщество
м?
источник

AY

Andrei Yemelianov in DocOps-сообщество
кто-нибудь в чате собирал с его помощью документы на языках с иероглифической письменностью? китайский, японский?
источник

AR

Anna Ryutina in DocOps-сообщество
у меня даже с русскими символами иногда проблемы) но если поставить словари, то должно быть норм. Но, все равно есть свои особенности
источник