Size: a a a

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

2020 January 15

FM

Fox Mulder in DocOps-сообщество
Спасибо Лана, актуально
источник

FM

Fox Mulder in DocOps-сообщество
прям мой стек:  md conf hugo git
источник

AR

Anna Ryutina in DocOps-сообщество
очепятка: длля

Foliant с Confluence в качестве бэкэнда

... Подробнее можно почитать тут, но если кратко, то он использует pandoc длля конвертации md в HTML, а затем публикует его в Confluence.
источник

НН

Нац Нац in DocOps-сообщество
Fox Mulder
прям мой стек:  md conf hugo git
🤔 там же совсем про другое или я что-то не уловил ПрИкОлА?
источник

FM

Fox Mulder in DocOps-сообщество
Нац Нац
🤔 там же совсем про другое или я что-то не уловил ПрИкОлА?
или я
источник

L

Lana in DocOps-сообщество
Fox Mulder
прям мой стек:  md conf hugo git
там все указанное выше есть, но без hugo
источник

NK

ID:0 in DocOps-сообщество
Лана шарит, читайте!
источник

NK

ID:0 in DocOps-сообщество
Я тут собрала все известные мне способы публикации из разметки в конфлуэнс в статейку, https://habr.com/ru/post/483898/ это чуть больше, чем я рассказывала на митапчике, так как sphinxcontribbuilder обновился 3 января и стал поддерживать много классных плюшек, типа джира фильтров, мат формул, нумерованных заголовков и т.д.
источник

ML

Maksim Lapshin in DocOps-сообщество
ID:
Я тут собрала все известные мне способы публикации из разметки в конфлуэнс в статейку, https://habr.com/ru/post/483898/ это чуть больше, чем я рассказывала на митапчике, так как sphinxcontribbuilder обновился 3 января и стал поддерживать много классных плюшек, типа джира фильтров, мат формул, нумерованных заголовков и т.д.
Я тут сделал первые робкие попытки юриста на гит перетащить :)

Но к сожалению офисные сотрудники привыкли к ворду(что само по себе бессмысленное беспощадное зло) и это пока не очень выходит.

Но в светлом будущем ворд будет заменен на текстовые гитопригодные форматы и это будет возможно
источник

L

Lana in DocOps-сообщество
Maksim Lapshin
Я тут сделал первые робкие попытки юриста на гит перетащить :)

Но к сожалению офисные сотрудники привыкли к ворду(что само по себе бессмысленное беспощадное зло) и это пока не очень выходит.

Но в светлом будущем ворд будет заменен на текстовые гитопригодные форматы и это будет возможно
А я на прошлой работе hr и маркетинг склонила к гиту, ничего, втянулись, нравится
источник

L

Lana in DocOps-сообщество
Звучит как преступление: принуждение к гиту
источник

ML

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

ML

Maksim Lapshin in DocOps-сообщество
Lana
А я на прошлой работе hr и маркетинг склонила к гиту, ничего, втянулись, нравится
Мы весь дизайн компании убрали в гит. Но там тяжко с картинками
источник

ML

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

Например, лейаут материнской платы вполне можно и нужно свести к текстовому формату, но никто из бородатых железячников такого не делал - они привыкли клик-клик мышкой без версий, ревизий, истории и прочего :(
источник

ML

Maksim Lapshin in DocOps-сообщество
ID:
Я тут собрала все известные мне способы публикации из разметки в конфлуэнс в статейку, https://habr.com/ru/post/483898/ это чуть больше, чем я рассказывала на митапчике, так как sphinxcontribbuilder обновился 3 января и стал поддерживать много классных плюшек, типа джира фильтров, мат формул, нумерованных заголовков и т.д.
О, кстати.

Мы у себя в флюссонике сделали такое:

Техпис пишет документацию на сайте, кое где проставляет теги, размечая определенную документацию.

Фронтендер пишет вебморду и кое где ставит контрол (в виде знака вопроса) с нужным тегом.

При компиляции это все собирается вместе и продукт уезжает кастомерам с документацией, которая свежезабралась с сайта на момент релиза софта.

Понятно, все автоматизировано и достаточно неплохо вышло.
источник
2020 January 16

NV

Nick Volynkin in DocOps-сообщество
Maksim Lapshin
О, кстати.

Мы у себя в флюссонике сделали такое:

Техпис пишет документацию на сайте, кое где проставляет теги, размечая определенную документацию.

Фронтендер пишет вебморду и кое где ставит контрол (в виде знака вопроса) с нужным тегом.

При компиляции это все собирается вместе и продукт уезжает кастомерам с документацией, которая свежезабралась с сайта на момент релиза софта.

Понятно, все автоматизировано и достаточно неплохо вышло.
Круто! Это материал для хорошей статьи и доклада )
источник

NV

Nick Volynkin in DocOps-сообщество
Maksim Lapshin
Хотел поделиться: мы сейчас делаем свое железо и шокировали производителя тем, что вместо традиционного вордового файла, который обрастает комментариями и конфликтующими версиями, позвали их в гит репозиторий с мерж реквестами, обсуждениями и тп
Тоже круто. Про это с интересом послушает сообщество приборостроителей Конвеерум, @medvedevkonstanteen
источник

AS

Al Sku in DocOps-сообщество
Maksim Lapshin
Я тут сделал первые робкие попытки юриста на гит перетащить :)

Но к сожалению офисные сотрудники привыкли к ворду(что само по себе бессмысленное беспощадное зло) и это пока не очень выходит.

Но в светлом будущем ворд будет заменен на текстовые гитопригодные форматы и это будет возможно
Юриста на гит  - чтобы что?
источник

RG

Ramil G in DocOps-сообщество
Maksim Lapshin
Я тут сделал первые робкие попытки юриста на гит перетащить :)

Но к сожалению офисные сотрудники привыкли к ворду(что само по себе бессмысленное беспощадное зло) и это пока не очень выходит.

Но в светлом будущем ворд будет заменен на текстовые гитопригодные форматы и это будет возможно
Юристов это жестоко. onedrive и office365 уже хватило бы
источник

NV

Nick Volynkin in DocOps-сообщество
Al Sku
Юриста на гит  - чтобы что?
Например, чтобы диффать юридические документы и сразу видеть, что поменялось. Но это мое предположение только. Интересно, что Максим расскажет.
источник