Size: a a a

KnowledgeConf Chat

2019 March 16

L

Lana in KnowledgeConf Chat
Итак, еще одна боль тимлида в управлении знаниями, разбираем кейс "Крупный банк с командой разработки. Есть кусок продукта, несколько проектов на нем, работает без документации, но скоро придется вносить изменения, разработчики у нас не пишут совсем, не принято, соответственно нужны усилия отдельного человека, есть идея отдать задачу системному аналитику". Как помочь?
источник

EN

Ekaterina Noskova in KnowledgeConf Chat
одного аналитика на всех может не хватить. может завести процесс документирования разработчиками?
источник

L

Lana in KnowledgeConf Chat
Ekaterina Noskova
одного аналитика на всех может не хватить. может завести процесс документирования разработчиками?
Ну вот специфика кейса, что этой практики нет и не планируется
источник

L

Lana in KnowledgeConf Chat
а аналитики тоже не писатели, даже если их много, надо расширять чьи-то роли в любом случае
источник

EN

Ekaterina Noskova in KnowledgeConf Chat
Lana
Ну вот специфика кейса, что этой практики нет и не планируется
специфика - разработчики, которые не хотят ничего решать, хотят только кодить?)
источник

L

Lana in KnowledgeConf Chat
Ekaterina Noskova
специфика - разработчики, которые не хотят ничего решать, хотят только кодить?)
ну решать может и хотят, но тимлид прививать им практики документирования сдался, видимо так
источник

L

Lana in KnowledgeConf Chat
мне идея отдать реверс инжиниринг и документирования системному аналитику кажется немного чересчур амбициозной, но если у конкретных людей достаточно скиллов на это - может и сработает
источник

EN

Ekaterina Noskova in KnowledgeConf Chat
а системный аналитик готов?
источник

L

Lana in KnowledgeConf Chat
Ekaterina Noskova
а системный аналитик готов?
речь шла про одного конкретного, она - да, вопрос масштабируемости
источник

TL

Taliya Ledneva in KnowledgeConf Chat
Lana
Итак, еще одна боль тимлида в управлении знаниями, разбираем кейс "Крупный банк с командой разработки. Есть кусок продукта, несколько проектов на нем, работает без документации, но скоро придется вносить изменения, разработчики у нас не пишут совсем, не принято, соответственно нужны усилия отдельного человека, есть идея отдать задачу системному аналитику". Как помочь?
А в чем конкретно проблема? Есть задача для аналитика, есть аналитик...
источник

L

Lana in KnowledgeConf Chat
Taliya Ledneva
А в чем конкретно проблема? Есть задача для аналитика, есть аналитик...
Проблему описывает первая часть Сообщения
источник

L

Lana in KnowledgeConf Chat
А аналитик решение, которое сам тимлид думает использовать
источник

EB

Elena Baskakova in KnowledgeConf Chat
Lana
Итак, еще одна боль тимлида в управлении знаниями, разбираем кейс "Крупный банк с командой разработки. Есть кусок продукта, несколько проектов на нем, работает без документации, но скоро придется вносить изменения, разработчики у нас не пишут совсем, не принято, соответственно нужны усилия отдельного человека, есть идея отдать задачу системному аналитику". Как помочь?
Разработчики даже не сопровождают свой код комментариями типа Java-доков?
источник

AD

Alexey Dushechkin in KnowledgeConf Chat
Меня вот эта вера в то, что разработчик нужен исключительно для того, чтобы писать код, несколько удивляет уже который год. Особенно если в должностях написано что-то типа software engineer. Писать код просто, я сам напишу сколько угодно. Проблемы решать сложно. Но если тимлид говорит «ладно» на «мы не хотим писать сами», то, мне кажется, у них не с документацией проблема.
источник

L

Lana in KnowledgeConf Chat
Alexey Dushechkin
Меня вот эта вера в то, что разработчик нужен исключительно для того, чтобы писать код, несколько удивляет уже который год. Особенно если в должностях написано что-то типа software engineer. Писать код просто, я сам напишу сколько угодно. Проблемы решать сложно. Но если тимлид говорит «ладно» на «мы не хотим писать сами», то, мне кажется, у них не с документацией проблема.
Скорее соглашусь, вопрос инженерной культуры
источник

SK

Stanislav Kapulkin in KnowledgeConf Chat
Lana
ну решать может и хотят, но тимлид прививать им практики документирования сдался, видимо так
Может быть, если предложить решение для документирования, более близкое к разработчикам, то будет проще его внедрить? Например https://m.habr.com/ru/post/416077/
источник

L

Lana in KnowledgeConf Chat
Вариант, но мне мои про plantuml, когда я добавила поддержку писать на нем в артефактах рядом с кодом, сказали, это что нам ещё один язык учить)))
источник

SK

Stanislav Kapulkin in KnowledgeConf Chat
Что сложного программисту еще один язык выучить)
источник

L

Lana in KnowledgeConf Chat
Stanislav Kapulkin
Что сложного программисту еще один язык выучить)
Именно в этом парадокс
источник

OI

Olga Ilchukova in KnowledgeConf Chat
Lana
Итак, еще одна боль тимлида в управлении знаниями, разбираем кейс "Крупный банк с командой разработки. Есть кусок продукта, несколько проектов на нем, работает без документации, но скоро придется вносить изменения, разработчики у нас не пишут совсем, не принято, соответственно нужны усилия отдельного человека, есть идея отдать задачу системному аналитику". Как помочь?
Я вижу в этой ситуации следующее. Тимлид осознал необходимость документирования и готов выделить отдельный ресурс под эту задачу. Это неплохой первый шаг к успеху, не каждый может этим похватстаться.

В качестве отдельного ресурса лучше сразу определить (найти, нанять, уговорить) технического писателя, человека, который знает, как и что писать, знает процессы документирования.

При этом тимлиду надо четко понимать, что техписатель — не подорожник. Даже если бы это был аналитик или кто-либо еще, то проблема бы не решилась только выделением ресурса. Если появилась новая для команды задача, то, вероятно, нужно с нуля внедрить процесс документирования. Техписатель это тот, кто может помочь с этим.

Да, к сожалению, в команде тимлида не укоренилась культура документирования. Тем не менее в новом процессе разработчикам все равно придется участвовать в качестве экспертов, помощников, консультантов. Как разработчикам участвовать во взаимодействии с техписателем, как раз и должен разрулить тимлид и укоренить это взаимодействие в правилах нового для команды процесса документирования.

Решение этой задачи мне видится таким.

Совмещение ролей аналитика и техписа не могу рассмотреть, потому что функциональное наполнение роли аналитика варьируется от команды к команде. Возможно, в команде этого тимлида аналитик глубоко укоренен в процесс разработки: проектирует, тестирует, экспериментирует с решениями, каждый день работает над фидбэком от пользователей и анализирует его с 100500 разных позиций. + в задаче не сказано об объеме задачи по документации. Возможно, там куча всего. Аналитик просто не вывезет.
источник