Size: a a a

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

2019 July 26

AY

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

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

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

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

АП

Александр Парень in DocOps-сообщество
источник

ДБ

Дмитрий Башкирцев in DocOps-сообщество
Andrei Yemelianov
Я использовал ЛаТех, кстати
насколько удобно и высокий ли порог входа?
источник

RZ

Roman Zh in DocOps-сообщество
Александр Парень
И я надеялся тебя увидеть
Я специально приехал😂
источник

AY

Andrei Yemelianov in DocOps-сообщество
Дмитрий Башкирцев
насколько удобно и высокий ли порог входа?
Порог входа... У меня было нормально.  В плане удобства - на любителя
источник

НН

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

НН

Нац Нац in DocOps-сообщество
Сложнее md asciidoc, уровень html +-
источник

ДБ

Дмитрий Башкирцев in DocOps-сообщество
просто первый выступающий говорил про проблемы верстки
источник

ДБ

Дмитрий Башкирцев in DocOps-сообщество
и вот если маркдаун и рст всё плохо, то может лучше латех
источник

RZ

Roman Zh in DocOps-сообщество
Для сложных мат формул латекс хорош
источник

NV

Nick Volynkin in DocOps-сообщество
Друзья, я отключаюсь, у меня ночь уже. :)
Хорошего вам митапа, приходите ещё!

Если хотите тоже рассказать о чём-нибудь, напишите мне или киньте заявку на https://goo.gl/forms/4kzv4bjGNZMvsdxH2
источник

RZ

Roman Zh in DocOps-сообщество
Nick Volynkin
Друзья, я отключаюсь, у меня ночь уже. :)
Хорошего вам митапа, приходите ещё!

Если хотите тоже рассказать о чём-нибудь, напишите мне или киньте заявку на https://goo.gl/forms/4kzv4bjGNZMvsdxH2
Спасибо, надеюсь увидимся на следующем митапе
источник

K

Konstantin in DocOps-сообщество
Кирилл Со
Можешь привести примеры доков?
Мы по гитфлоу, например, ведём большее руководство на >1500 страниц для администраторов наше мега-админки
источник

КС

Кирилл Со in DocOps-сообщество
источник

K

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

Всё остальное из этого прекрасного списка мы (в docs.plesk.com) уже делаем сами и всем рекомендуем. :)
Крайне рекомендую: https://keepachangelog.com/en/1.0.0/
источник

K

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

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

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

Димитрий Башкирцевич
​при сквоше блэйм удобно смотреть?
Мы используем Латех через Pandoc при сборке PDF-файлов: маркдаун конвертится в Латех и добавляется специально настроенная преамбула.
источник

K

Konstantin in DocOps-сообщество
В итоге качественная вёрстка в PDF и не надо учить людей Латеху
источник

K

Konstantin in DocOps-сообщество
Латеховые формулы поддерживаются пандоком из коробки, плюс мы ещё препроцессоров накрутили
источник

ДБ

Дмитрий Башкирцев in DocOps-сообщество
Konstantin
Мы используем Латех через Pandoc при сборке PDF-файлов: маркдаун конвертится в Латех и добавляется специально настроенная преамбула.
пасиб
источник

RZ

Roman Zh in DocOps-сообщество
Konstantin
В итоге качественная вёрстка в PDF и не надо учить людей Латеху
Изящное решение! Спасибо
источник