Size: a a a

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

2021 September 02

Т

Татьяна Ирбулдина... in DocOps-сообщество
Коллеги, в обсуждении перехода на Docs-as-Code возник вопрос) на этапе Pull Request в Git возможно ли вносить правки в документ?) И вообще возможно ли в ходе ревью изменять документ (а не писать длинный комментарий исправить опечатку)?
источник

AR

Anna Ryutina in DocOps-сообщество
в самом гите же есть возможность Edit (в merge requests) только это не самая хорошая практика)
источник

Т

Татьяна Ирбулдина... in DocOps-сообщество
А как удобно организовать процесс, чтобы ревьюер мог вносить незначительные правки в ходе ревью?
источник

AR

Anna Ryutina in DocOps-сообщество
делать все изменения в текущей ветке, и затем пушить
источник

AR

Anna Ryutina in DocOps-сообщество
ну или создавать еще одну ветку от текущей, делать там правки, затем вливать в ветку
источник

AS

Alexey Simmons in DocOps-сообщество
Если используете Bitbucket Server, то ревьюер может предлагать свои изменения при помощи этой кнопки. А автор потом нажмет Apply Suggestion и они сразу коммитом влетят в реквест. Может и в других гит-системах такое есть
источник

L

Lex in DocOps-сообщество
Аналогично в гитлабе можно прямо в мерж реквесте предлагать правки. Целую охапку правок можно единым коммитом провести
источник
2021 September 03

E

Ekaterina in DocOps-сообщество
На гитхабе (не enterprise версии только) тоже можно предлагать изменения, в том числе сразу на несколько строк. Очень удобно.
источник

ИЦ

Игорь Цупко... in DocOps-сообщество
править в ветке, а не писать длинный коммент — прекрасная практика, экономящая время. Но надо чётко отличать где правку можно так внести сразу (потому что вы - лицо принимающее решение, либо потому что это тупая опечатка), а где — нужно обсудить по-братски.
Даже если все внесённые правки окажутся безобразием — это ж гит, их легко откатить
источник

E

Ekaterina in DocOps-сообщество
Вот только не всегда есть возможность вносить изменения в чужую ветку напрямую (автор реквеста может разрешать/запрещать редактирование контента в своей ветке)
источник

D

Denis in DocOps-сообщество
Коллеги, конвертирую docx в rst. При этом pandoc производит некие символы, которые как пробел, но пробел) Не сталкивались с таким?
источник

ML

Maksim Lapshin in DocOps-сообщество
Неразрывный пробел?
источник
2021 September 06

D

Denis in DocOps-сообщество
Да, это было оно. Спасибо за идею!
источник
2021 September 07

NK

ID:0 in DocOps-сообщество
А где можно публиковать статьи на английском? Хотим рассказывать про Тарантул международному сообществу. Накидайте площадок, пожалуйста )
источник

EN

Ekaterina Noskova in DocOps-сообщество
medium
источник

AM

Alexander Makarov in DocOps-сообщество
Reddit, dev.to, habr
источник

R

Roman in DocOps-сообщество
Habr
источник

EV

Evgeny Victorov in DocOps-сообщество
LinkedIn, Reddit
источник

АМ

Александра Мирзуитов... in DocOps-сообщество
Medium
источник

NV

Nick Volynkin in DocOps-сообщество
А Хабр кто-то читает на английском?
источник