Size: a a a

2020 January 05

AZ

Alexandr Zag in technicalwriters
Друзья, с наступившим вас! Интересно ли будет вам, если в рамках чата проведем опрос про свои инструменты, форматы разметки и подобное для подготовки документации? В лаконичной и свободной форме, а через неделю-другую подведем итоги? Если идея интресна, перечислите кратко что  используете c хэштэгом #usedoc.  Начну с себя:
источник

AZ

Alexandr Zag in technicalwriters
Аналитик, использую G Suite: google docs + google drive , confluence (markdown) #usedoc
источник
2020 January 07

АП

Александр Парень in technicalwriters
Всем, кто пользует Confluence Cloud, Atlassian проведет вебинарчики, причем для разных таймзон https://www.atlassian.com/webinars/software/how-to-get-the-most-out-of-confluence-cloud
источник

АП

Александр Парень in technicalwriters
На слак-чате WTD увидел:

Some possible requirements for documentation tools
http://lauriston.com/requirements_sanitized.pdf
источник
2020 January 09

АИ

Александр Ильющеня in technicalwriters
Привет, всем! Ведем документацию как проект в gitlab (не вики, а именно проект), оформляем с помощью Markdown. Заказчик поставил требование, чтобы информация из master-ветки была оформлена в виде отдельного пространства в Сonfluence и автоматически актуализировалась при обновлении master-ветки. Может кто сталкивался с подобной задачей, поделитесь, пожалуйста, опытом.
источник

HK

Hanna Khyzhnia in technicalwriters
Александр Ильющеня
Привет, всем! Ведем документацию как проект в gitlab (не вики, а именно проект), оформляем с помощью Markdown. Заказчик поставил требование, чтобы информация из master-ветки была оформлена в виде отдельного пространства в Сonfluence и автоматически актуализировалась при обновлении master-ветки. Может кто сталкивался с подобной задачей, поделитесь, пожалуйста, опытом.
у меня похоже у клиента так настроена система. Они используют дженкинс для этого.
источник

НН

Нац Нац in technicalwriters
Hanna Khyzhnia
у меня похоже у клиента так настроена система. Они используют дженкинс для этого.
Мне бы тоже интересно было, там какой-то костыльный самописный скрипт для этого или какое-то готовое решение? Я искал что-то годное и не нашел ничего, где не надо ещё шаманить потом руками всякое
источник

HK

Hanna Khyzhnia in technicalwriters
по поводу настройки - не могу ничего подсказать.
источник

HK

Hanna Khyzhnia in technicalwriters
знаю, что еще есть пайплайны в самом гитлабе - может через них можно настроить.
источник

АИ

Александр Ильющеня in technicalwriters
Я нашел предложение сделать самописный скрипт: https://community.atlassian.com/t5/Confluence-questions/Import-markdown-into-Confluence/qaq-p/211797#M85598

но может велосипед уже до меня изобрели?
источник

НН

Нац Нац in technicalwriters
Если для того чтобы как-то с маркдауном работать в конфе нужен плагин (лол), то до автоматического импорта/экспорта ещё с десяток лет ждать, думается мне. Но был бы рад быть неправым
источник

B

Borodalo in technicalwriters
Нац Нац
Если для того чтобы как-то с маркдауном работать в конфе нужен плагин (лол), то до автоматического импорта/экспорта ещё с десяток лет ждать, думается мне. Но был бы рад быть неправым
источник

NV

Nick Volynkin in technicalwriters
Александр Ильющеня
Привет, всем! Ведем документацию как проект в gitlab (не вики, а именно проект), оформляем с помощью Markdown. Заказчик поставил требование, чтобы информация из master-ветки была оформлена в виде отдельного пространства в Сonfluence и автоматически актуализировалась при обновлении master-ветки. Может кто сталкивался с подобной задачей, поделитесь, пожалуйста, опытом.
Можно взять Sphinx, плагин для markdown и плагин sphinxcontrib-confluencebuilder, собрать из них пайплайн для публикации, прикрутить его к CI. По коммитам в мастер документация будет пушиться в конфлюенс.
источник

НН

Нац Нац in technicalwriters
(засмеялся)
источник

B

Borodalo in technicalwriters
Нац Нац
(засмеялся)
норм, без объяснения причин 😂
Или всё таки будет комментарий к смеху?
источник

NV

Nick Volynkin in technicalwriters
Похоже, что тут придётся руками контент перекладывать в конфлюенс. Или там есть API?
источник

НН

Нац Нац in technicalwriters
Borodalo
норм, без объяснения причин 😂
Или всё таки будет комментарий к смеху?
Ну я сказал про плагин, ты мне его кинул (зачем-то), а он ещё и платный
источник

B

Borodalo in technicalwriters
Нац Нац
Ну я сказал про плагин, ты мне его кинул (зачем-то), а он ещё и платный
я прочитал слово "если", значит не было известно о его существовании.
Конфа поддерживает возможность складывания MD без плагина, но без плагина не поддерживается дальнейшая правка, только пересоздание документа.
И не понимаю что удивляет в платности плагинов в коммерческом продукте
источник

B

Borodalo in technicalwriters
Nick Volynkin
Похоже, что тут придётся руками контент перекладывать в конфлюенс. Или там есть API?
к сожалению не интересовался
источник

NV

Nick Volynkin in technicalwriters
Если есть требование, чтобы дока «автоматически актуализировалась», то такой способ не подходит.
источник