Size: a a a

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

2019 July 26

NV

Nick Volynkin in DocOps-сообщество
*Trunk-based*

Второй по популярности способ. Все ветки делаем от master и мержим обратно.
источник

NV

Nick Volynkin in DocOps-сообщество
Кирилл Со
Можешь привести примеры доков?
Точнее всего ответит @kvaleev, он докладчик. Я думаю, что git flow оправдано для сложной документации, в которой высока цена ошибки и которую мы релизим не в веб, а, например, на бумагу.
источник

NV

Nick Volynkin in DocOps-сообщество
Например, мы делаем пылесосы или танки. Цикл релиза продукта долгий, документацию тоже долго копим и проверяем. После выпуска исправить ошибки в документации будет очень сложно.
источник

NV

Nick Volynkin in DocOps-сообщество
Снова по докладу: часто нужен не просто документ, а привязанный к коду документ.
источник

NV

Nick Volynkin in DocOps-сообщество
Способ 1: прямо в репозитории с кодом, в отдельной папке или в отдельных файлах рядом с кодом. Тогда берём тот же воркфлоу, который используют разработчики.
Есть два варианта работы с мерж-реквестами. 1) можно писать документацию вместе с кодом и не мержить код, пока не готова документация. 2) можно писать документацию в отдельных ветках и проверять в отдельных мерж-реквестах.
источник

RZ

Roman Zh in DocOps-сообщество
Нац Нац
Гудлак хэвфан всем на митапе, зырну вас на выхах
😊
источник

NK

ID:0 in DocOps-сообщество
​​Классная идея, которую я только что узнал из доклада — это release notes для самой документации. Обновили раздел А, переписали документ Б. Обязательно попробую. Пока что у нас это только в сообщениях коммитов есть, но отдельный документ может быть интересен сам по себе.

Всё остальное из этого прекрасного списка мы (в docs.plesk.com) уже делаем сами и всем рекомендуем. :)
источник

NV

Nick Volynkin in DocOps-сообщество
Вопрос Косте, @Lananovikova озвучишь?

В компании же много продуктов. Как-то разделяете документацию к разным продуктам и для разных пользователей по репозиториям? Или всё в одном репозитории?

Переводите ли вы документацию и как работаете с ветками для переводов?
источник

NV

Nick Volynkin in DocOps-сообщество
Хей, там @SashP84 отличные вопросы задает )
источник

RZ

Roman Zh in DocOps-сообщество
Nick Volynkin
Хей, там @SashP84 отличные вопросы задает )
Намучился с конфой видно
источник

NV

Nick Volynkin in DocOps-сообщество
У него много опыта с конфлюенсом )
источник

АП

Александр Парень in DocOps-сообщество
Nick Volynkin
У него много опыта с конфлюенсом )
Завтра мой доклад на ITGlobalMeetup
источник

АП

Александр Парень in DocOps-сообщество
Nick Volynkin
У него много опыта с конфлюенсом )
И я надеялся тебя увидеть
источник

L

Lana in DocOps-сообщество
В питере уже?)
источник

AY

Andrei Yemelianov in DocOps-сообщество
Александр Парень
Завтра мой доклад на ITGlobalMeetup
О чём?
источник

АП

Александр Парень in DocOps-сообщество
Lana
В питере уже?)
Ага, ночью обратно на поезд
источник

L

Lana in DocOps-сообщество
Александр Парень
Ага, ночью обратно на поезд
Жжёшь
источник

ДБ

Дмитрий Башкирцев in DocOps-сообщество
Димитрий Башкирцевич
​Как на счет использования латеха для документации?

Димитрий Башкирцевич
​насколько это маргинально и нецелесообразно?

Димитрий Башкирцевич
​насколько хорошо использовать ограниченное количество веток для ведения документации? не используете ли ветки с именами задач? или вы брэнчитесь от эпик/фич веток?

Димитрий Башкирцевич
​при сквоше блэйм удобно смотреть?
источник

ДБ

Дмитрий Башкирцев in DocOps-сообщество
источник

L

Lana in DocOps-сообщество
Почему я)))
источник