207 похожих чатов

Коллеги, всех приветствую. На текущем проекте столкнулся с такой крайне

сложной для меня ситуации (потому что наверное не сталкивался с ней ранее), что документация на проекте от одного аналитика не терпит никакой критики, т.е она не местами некачественная, она структурно или можно сказать стратегически неверно написана, т.е читаешь ее, написанную вроде на русском языке, но не понимаешь, даже на 10 раз прочтения порой. И каждое предложение в документации по сути ребус.
Я тестил документацию на разные проектах, плюс минус понимаю, как и что в доке нужно править, а вот тут вообще непонятно как подступиться, ибо сам факт существования этой документация - большая ошибка, от которой страдает, насколько я знаю, вся команда.
Как бы вы поступили в такой ситуации? Не хотелось бы со всей аналитикой перессориться, но лобби у них на моем текущем проекте очень сильное, могут закидать помидорами тут же))

9 ответов

13 просмотров

Постою послушаю ответы) Тоже была в такой ситуации. И проблема не в том, как донести до такого аналитика, что нужно писать не так, а в том, что у него как-то по-другому устроены мозги, и он просто не может иначе. Мы пытались для начала попросить уделять больше внимания структурированию задачи, разделению её на части. Но от этого местами становилось только хуже. А потом этот аналитик уволился (не знаю, связано ли это было с жалобами), и проблема решилась сама собой. Но вот как бы можно было с этим работать, интересно.

Sasha-Ivanov Автор вопроса
Polina Mishchenko
Постою послушаю ответы) Тоже была в такой ситуации...

даа, вот я об этом и говорю, что человек мыслит нестандартно и вообще не разумеет, а что тут непонятного?)

1. Проверить поднимался ли это вопрос раньше Собрать инфо Посмотреть Отжать Отложить- пригодится позже 2. Оценить обстановку- аккуратно спросить разных вовлеченных людей мнение . Запомнить кто за кто против кого можно перетянуть 3. ПОдготовить почву - начать капать вежливо и методично легкими замечаниями и упоминаниями 4 Одна или несколько решительных встреч обсуждений- быть готовым и ярко ,обоснованно и как принято в данной компании показть , почему и как надо менять . Лучше договориться . Но можно и нажать на кое какие точки 5 Закрепить успех . Упомянуть как стало хорошо всем ( не только вам) и особенно боссу Сделать это эмоционально и наглядно Поддержать отзывами коллег Но надо ли это все? Те затраты и резльтат хорошо заранее оценить .. просто впечатление от документации токо вершин айсберга

Kirill Buzukov
1. Проверить поднимался ли это вопрос раньше Собра...

Я один раз так сказанул на проекте будучи разрабом, только не плавно, а прямиком сразу директору, что тут много что улучшать и править весь говнокод, но меня решили уволить Больше так делать не буду)

Roman Salnikov
Я один раз так сказанул на проекте будучи разрабом...

Разыгрывать офисные партии- отдельная большая тема . Это ж как и любое сложное дело требует подготовки, правильных шагов, гибкости и многого другого Конечно , не надо будить .. и бросать..и тыкать.. и дергать за усы без правильного подхода- получится, скорее всего , не круто

Kirill Buzukov
1. Проверить поднимался ли это вопрос раньше Собра...

Так можно на ретро сказать просто - была вот такая проблема. Если команда согласна - они поддержат.

У технической документации есть ряд общепринятых свойств, по которым можно считать её качественной или наоборот. Кроме того - документацию тоже можно(нужно) тестировать и на неё можно писать баги. В том числе баги можно писать не на конкретный участок документации, а сообщить о системной ошибке в документации приведя несколько примеров. Прям вводишь в гугл "тестирование проектной документации" - парочку годных статей выдаст точно.

Когда ты видишь регулярные баги от одного разработчика - что ты обычно делаешь?)

Richard Gears
Когда ты видишь регулярные баги от одного разработ...

Делаю специальный чек-лист "типичные баги от Лёши", раздаю другим QA в отделе, пингую Лёшу что он з***л и сообщаю проект-менеджеру. В моей практике эффект возымел только чек-лист.

Похожие вопросы

Обсуждают сегодня

Вопрос по диагностике ошибок (я знаю в чем, в данном конкретном примере, я знаю, как исправить, пример модельный, понятно, что в реальности бывает намного запутаннее). module...
ⰄⰎⰋⰐⰐⰑⰛⰤⰧⰧⰩⰄ ⰊⰑⰁⰓⰡⰛⰦⰕⰫ
10
А чем вам питонисты не угодили?😂
.
79
Есть какой-нибудь для Delphi/FPC T*Compression(Decompression)Stream на базе LZ4/Zstd/любой другой быстрый(и хорошо сжимающий) алгоритм А ещё лучше в pure pascal А ещё лучше од...
notme
48
Есть предложения, как подобное можно упростить?
Hemul GM
12
type TObj = object procedure Init; virtual; end; TObj1 = object(TObj) procedure Init; override; end; procedure TObj1.Init; begin inherited; end; procedur...
Alexander 👋
29
У меня вопросик назрел. Почему, создав класс без наследования и реализации деструктора Destroy, деструктор не вызывался при free. Потом указал наследование от tobject и overri...
Сергей Бычков
9
Такой вопросец - есть функция function MySuperDuperConcat(const a: array of AnsiString): AnsiString; Как мне в её теле сделать вот так? Result:=Concat(a); А не грустный вариан...
notme
15
just use free version ?? pycharm has a free version
Fan / Ac
9
Всем привет, написал код ниже, но он выдает сегфолт, в чем причина? #include <stdio.h> #include <stdlib.h> #include <string.h> struct product { char *name; float price; };...
buzz базз
86
Привет, не могли бы подсказать почему "A tree falls in a forest" не отображается в journalctl? openlog ("exampleprog", LOG_CONS | LOG_PID | LOG_NDELAY, LOG_LOCAL1); syslog (LO...
•_• Asmanov 🎓
3
Карта сайта