Size: a a a

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

2018 August 28

NV

Nick Volynkin in DocOps-сообщество
Первую пишет тот, кто ставит задачу на разработку. Вторую — обычно разработчики, потому что нужно подробно знать, как внутри всё устроено. Доки на API обычно выгружают из кода и автоматизируют процесс, а текстовую их часть пишут техписатели. Третью — техписатели, а если их нет, то кто-нибудь.
источник

AG

Alexey Golubev in DocOps-сообщество
А тест кейсы частично не покрывают третий тип?
источник

NV

Nick Volynkin in DocOps-сообщество
Вряд ли пользователи будут их читать.
источник

NV

Nick Volynkin in DocOps-сообщество
Но пользователям документация вообще может быть не нужна.
источник

AG

Alexey Golubev in DocOps-сообщество
У нас не возникает необходимости писать документацию для пользователей, только для заказчика. Чтобы он имел возможность доработать систему, при необходимости.
источник

AG

Alexey Golubev in DocOps-сообщество
Правильно ли я понимаю, что требования и спецификации достаточно хранить в задачах issue трекера?
источник

NV

Nick Volynkin in DocOps-сообщество
а вы сможете передать их заказчику?
источник

AG

Alexey Golubev in DocOps-сообщество
Да, клиент зачастую находится в системе трекинга задач и может отслеживать продвижение команды по спринту
источник

AG

Alexey Golubev in DocOps-сообщество
Соответсвенно имеет доступ ко всем обсуждениям и более того, сам часто принимает участие в них
источник
2018 August 29

SV

Ser V in DocOps-сообщество
Alexey Golubev
Соответсвенно имеет доступ ко всем обсуждениям и более того, сам часто принимает участие в них
смело, обычно доступ не дают в целях избежания ситуаций когда отдел маркетинга продал суперкрутую фичу за многоденег при этом человеко-часов разработчиков израсходовано на нее всего ничего
источник

NV

Nick Volynkin in DocOps-сообщество
OMG, за ночь +35 читателей канала. Откуда?
источник

NV

Nick Volynkin in DocOps-сообщество
Alexey Golubev
Правильно ли я понимаю, что требования и спецификации достаточно хранить в задачах issue трекера?
Тут меня смущает, что на уровне отдельных задач в трекере нет цельной картины требований бизнеса. И её может быть сложно восстановить только по трекеру.
источник

AM

Amir Me in DocOps-сообщество
По своему опыту скажу, что восстанавливать какие-то исторические требования по трекеру это еще та задача)
Лучше когда, хоть кусочками, но какая-то документация
источник

ME

Maria Ermakovich in DocOps-сообщество
@Nick_Volynkin а какое в итоге оказалось соотношение записавшихся/пришедших на митап?
источник

ME

Maria Ermakovich in DocOps-сообщество
интересно)
источник

NV

Nick Volynkin in DocOps-сообщество
Maria Ermakovich
@Nick_Volynkin а какое в итоге оказалось соотношение записавшихся/пришедших на митап?
28/48. Не считая оргов и докладчиков, которые точно пришли бы, 22/42.
источник

DB

Dima Boger in DocOps-сообщество
Хорошие цифры
источник

NV

Nick Volynkin in DocOps-сообщество
Ну выходит больше 50%, которые по умолчанию предполагают.
источник

L

Lana in DocOps-сообщество
19-00 это прям впритык, чтобы успеть в Москве, я прям бежала)
источник

NV

Nick Volynkin in DocOps-сообщество
Лана, спасибо тебе, что добежала )
источник