Size: a a a

technicalwriters

2020 November 28

MS

Maria Shabanova in technicalwriters
А вообще хорошая идея добавить в задачницу статус "документирование" 🤔
источник

S

Sirius in technicalwriters
Hartmann
Если вышестоящее начальство по какими-то причинам не понимает, не осознаёт или не хочет осознавать (если до его сведения доводят всю необходимую информацию, разумеется), что подобные вопросы приводят к финансовым потерям, то вряд ли Вам удастся кардинально на что-то повлиять и переломить ситуацию.
Ключевая мысль здесь, как и везде — деньги. Плохо настроены процессы — убытки, трата времени сотрудников — снова убытки, не налажена коммуникация — убытки.
По-моему, взрослые люди должны понимать такие вещи.
Ну бизнес процветает просто в геометрической прогрессии каждый год)
Несмотря ни на что, поэтому и не верят)
источник

S

Sirius in technicalwriters
Maria Shabanova
А вообще хорошая идея добавить в задачницу статус "документирование" 🤔
Интересная идея, можно ее озвучить на одном из собрании попробовав склонить к этому
источник

S

Sirius in technicalwriters
И да, тоже думала просить создать канал Release notes
Чтобы сообщали обо всех изменениях хоть туда.

У нас есть один, но туда попадают только самые крупные изменения (и по тем изменениям конечно есть дока и отдельный лендинг и так)

Это даже не изменение, это
наверное скорее просто кардинально новый функционал

И наверное нужен отдельный чат чтобы попадали все мелкие.. вплоть до изменения кнопки..
Просто что говорят что времени нет такое описывать

Самое высшее руководство скорее всего гонит быстрее и больше расширятся 🤷🏼‍♀️ вот как-то так..
источник

S

Sirius in technicalwriters
А по багам release notes отвечают
«Ну кто создал задачу - точно же поймёт что уже починили и клиента оповестили»
Как-то так..

Хотя я видела в приложениях release notes, прикольно. Но не знаю кто их пишет обычно
источник

EN

Ekaterina Noskova in technicalwriters
Александр Мокрушин
Никто лучше писателя не определит, влияет ли задача на документацию.
Документирование можно сделать последним этапом процесса. Писатель решает описывать или закрывать задачу
если стори закроется только тогда, когда документация напишется, это может негативно влиять на статистику закрытия спринтов. это сработает, если есть выделенный техпис на команду и документация пишется параллельно с разработкой например или люфт между разработкой и документацией минимальный. у команды, к слову, тоже есть понимание, нужна документация или нет, не только техпис может это определять
источник

rK

rJIynbIu` KOT in technicalwriters
у нас мильён задач в жире у прогеров/кодеров, они там, что-то делают, как новое добавляют, изменяют или даже вырезают. Но практически любая такая задача по цепочке статусов оканчивается на тестировщиках и писателях. Прям статус в жире "тестирование" или "документация" и задача переводится на конкретного человека. Иногда задача закрывается, но в комментах ставят упоминание техписа с фразой "требуется документирование", иногда они не знают действительно ли оно требуется и тогда так и пишут "возможно требуется документирование". Короч никаких проблем по поиску того, что надо документировать, всё падает уведомлениями жиры. И если были изменения, а техписы не были уведомлены об этом - спрос только с разрабов. Был момент, когда много работы было и перестали упоминать техписов, обсудили проблему с тимлидами, те провели беседу с разрабами, решили не закидывать такую систему и щас всё ровно.
источник

rK

rJIynbIu` KOT in technicalwriters
сейчас даже до окончания выполнения задачи могут маякнуть мол документируйте, это когда там ТЗ нормальное и всё что должно быть хорошо описано. ну мы даже заранее что-то написать можем, потом просто или скрины добавить или вообще только сверить, что всё как и планировали реализовали
источник

M

Maeg in technicalwriters
rJIynbIu` KOT
сейчас даже до окончания выполнения задачи могут маякнуть мол документируйте, это когда там ТЗ нормальное и всё что должно быть хорошо описано. ну мы даже заранее что-то написать можем, потом просто или скрины добавить или вообще только сверить, что всё как и планировали реализовали
Организация здорового человека 😍
источник

a

arvikon in technicalwriters
rJIynbIu` KOT
у нас мильён задач в жире у прогеров/кодеров, они там, что-то делают, как новое добавляют, изменяют или даже вырезают. Но практически любая такая задача по цепочке статусов оканчивается на тестировщиках и писателях. Прям статус в жире "тестирование" или "документация" и задача переводится на конкретного человека. Иногда задача закрывается, но в комментах ставят упоминание техписа с фразой "требуется документирование", иногда они не знают действительно ли оно требуется и тогда так и пишут "возможно требуется документирование". Короч никаких проблем по поиску того, что надо документировать, всё падает уведомлениями жиры. И если были изменения, а техписы не были уведомлены об этом - спрос только с разрабов. Был момент, когда много работы было и перестали упоминать техписов, обсудили проблему с тимлидами, те провели беседу с разрабами, решили не закидывать такую систему и щас всё ровно.
Аналогичная ситуация. В Джире в каждой задаче есть поле 'Документация'. Три статуса: нужна, не нужна, возможно. На отдельной странице, когда начинается тестирование, в таблицу автоматически собирается всё, что входит в релиз. Сразу видно тип задачи, статус для доков, и т.д. Выясняем-уточняем нюансы и пишем.
источник

YD

Yuri Dobrev in technicalwriters
arvikon
Аналогичная ситуация. В Джире в каждой задаче есть поле 'Документация'. Три статуса: нужна, не нужна, возможно. На отдельной странице, когда начинается тестирование, в таблицу автоматически собирается всё, что входит в релиз. Сразу видно тип задачи, статус для доков, и т.д. Выясняем-уточняем нюансы и пишем.
Хм, а зачем "возможно"? Это же всё равно как "нужна", то есть техпису надо смотреть разбираться
источник

a

arvikon in technicalwriters
Yuri Dobrev
Хм, а зачем "возможно"? Это же всё равно как "нужна", то есть техпису надо смотреть разбираться
Как это 'всё равно как "нужна" ' ? Т.е. в прогнозе погоды "будут осадки" и "возможно будут осадки" это одно и то же? Там где документация "нужна", мы не тратим время на определение, писать или нет, стоит или не стоит. Сразу берём в работу. Может быть несколько мнений, соответственно, потратим время на лишние обсуждения со всеми заинтересованными лицами. Так лучше это время уделить "возможной" документации, там где стоит глобальный вопрос, а нужно ли вообще. К тому же существуют моменты когда тот, кто выполнял задачу действительно не уверен нужна ли к ней документация, может не стоит это выносить на публику, скажем, по "политическим" причинам...
источник

YD

Yuri Dobrev in technicalwriters
arvikon
Как это 'всё равно как "нужна" ' ? Т.е. в прогнозе погоды "будут осадки" и "возможно будут осадки" это одно и то же? Там где документация "нужна", мы не тратим время на определение, писать или нет, стоит или не стоит. Сразу берём в работу. Может быть несколько мнений, соответственно, потратим время на лишние обсуждения со всеми заинтересованными лицами. Так лучше это время уделить "возможной" документации, там где стоит глобальный вопрос, а нужно ли вообще. К тому же существуют моменты когда тот, кто выполнял задачу действительно не уверен нужна ли к ней документация, может не стоит это выносить на публику, скажем, по "политическим" причинам...
Хороший пример про осадки. Зонт ведь взять придётся, если они "возможно будут". Цена ошибки "зря взял зонт" меньше по сравнению с "не взять и промокнуть" . Моя идея в том, что человеку проще поставить галку, что дока нужна, когда это не совсем понятно, потому что дальше специалист все равно будет решать надо или нет на самом деле. И ничего страшного, условный аналитик, который завёл таску, не обязан безошибочно определять влияние на доку. У нас так, по крайней мере. Был бы третий вариант "возможно", его бы ставили в большинстве случаев
источник

CD

Constantine Drozdov in technicalwriters
Yuri Dobrev
Хороший пример про осадки. Зонт ведь взять придётся, если они "возможно будут". Цена ошибки "зря взял зонт" меньше по сравнению с "не взять и промокнуть" . Моя идея в том, что человеку проще поставить галку, что дока нужна, когда это не совсем понятно, потому что дальше специалист все равно будет решать надо или нет на самом деле. И ничего страшного, условный аналитик, который завёл таску, не обязан безошибочно определять влияние на доку. У нас так, по крайней мере. Был бы третий вариант "возможно", его бы ставили в большинстве случаев
Есть разные процессы принятия решения группой людей. Товарищи, очевидно, хотят "один из двух считает необходимым".
источник

YD

Yuri Dobrev in technicalwriters
прикрутить голосовалку тогда что ли и порог задать, когда "нужно" :)
источник

CD

Constantine Drozdov in technicalwriters
Yuri Dobrev
прикрутить голосовалку тогда что ли и порог задать, когда "нужно" :)
Мне намного больше нравится версия "возможно/нужно"
источник

FM

Fox Mulder in technicalwriters
Термины и сокращения
ТП - технический писатель (техническая писательница)
««««
1. KPI. Данная штука ломает любою возможную инициативу членов разных команд помогать друг другу, если эта помощь никак не повлияет на kpi. Такое встречается как в российских компаниях, так и иностранных, например, я подобное читал про Google
2. Амбиции. Бывает так, что есть, например, две команды разработчиков, которые пилят свои фичи для одного продукта. И тимлиды у них разные, как и проджекты. В итоге, тимлид одной из более успешной команды может игнорить передачу знаний и помощь второй команде.
3. Квалификация техписа. Бывает так, что техпис сильно уступает в знаниях и неспособен беседовать с разрабами на одном языке. В следствии этого, ТП, выпадает из функциональных связей.
4. Перегруженность. Такое случается, когда у компании есть такое кол-во проектов, которые команды не могут переварить. В итоге при 146% разрабов на ТП не остаётся времени.
источник

M

Maeg in technicalwriters
Блин, аббревиатура ТП немного нервирует 😂😂
источник

a

arvikon in technicalwriters
Yuri Dobrev
Хороший пример про осадки. Зонт ведь взять придётся, если они "возможно будут". Цена ошибки "зря взял зонт" меньше по сравнению с "не взять и промокнуть" . Моя идея в том, что человеку проще поставить галку, что дока нужна, когда это не совсем понятно, потому что дальше специалист все равно будет решать надо или нет на самом деле. И ничего страшного, условный аналитик, который завёл таску, не обязан безошибочно определять влияние на доку. У нас так, по крайней мере. Был бы третий вариант "возможно", его бы ставили в большинстве случаев
Да, аналогия с осадками не подошла. Хотя лично я зонт не беру если возможны осадки :)
Тут два момента есть:
1. "Специалист будет решать", это кто? Техписатель? Не всегда же только мы можем решить.
2. Безошибочно определять никто никого не просит. Есть дополнительный статус для доки. И все. Может это мне повезло, но за 2 года работы в компании, было всего несколько случаев, когда ошиблись со статусом по докам.
3. И снова со своей колокольни - у нас никто не злоупотребляет "возможным" статусом. Никто (оптимист!) не любит неопределенность. Проставляют только если возникают обоснованные сомнения.
Каждому свое. Я привел пример из своей практики в поддержку поля для доков в Джире. Удобно. А что за статусы там каждый себе определит - другой вопрос.
источник

a

arvikon in technicalwriters
Maeg
Блин, аббревиатура ТП немного нервирует 😂😂
В меру распущенности)))
источник