Как задать вопрос, чтобы на него ответили

Сегодня про навык, который выглядит как ерунда, а на деле определяет, будешь ты рукопожатым или нет.

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

Классика номер один: «Привет»

Просто «Привет». Без всего. Точка, отправлено. Лично у меня жутко горит очко с этого.

И дальше человек на том конце сидит и смотрит на «печатает…» минуты три. Он не знает, что будет дальше: то ли ты попросишь глянуть логи, то ли позовёшь на созвон, то ли скажешь, что он мудак. Работать в этот момент он не может, потому что ждёт.
Есть даже сайт nohello.com, целиком посвящённый этой боли. Люди не поленились сделать сайт, представляешь, насколько всех задолбало.
Пиши сразу: «Привет, вопрос по стенду - он лежит или это у меня?». Всё, человек прочитал и уже думает над ответом, а не над тем, чего ты от него хочешь.

Классика номер два: «Не работает»

Ты в курсе, что не работает. Что видел ты и что видит человек по ту сторону экрана - две разные вселенные.
У него в голове нет твоего браузера, твоего стенда, твоего пользователя и твоих трёх часов ковыряния. Он видит два слова и всё.

Сравни:

«Не работает оплата, помоги»

и

«Оплата картой на деве, юзер под ролью менеджера. Нажимаю "оплатить" - крутится и падает в "что-то пошло не так". В Network 500 на POST /payments. Воспроизводится каждый раз, у коллеги тоже. Проверил другую роль - там ок. Есть идеи, куда копать?»
Второе сообщение длиннее? Да. Зато на него ответят за минуту, а на первое будут неделю выпытывать подробности, и все останутся недовольны.

Классика номер три: «Я ничего не знаю, помоги»

Когда человек пишет «объясни мне API» - он не задаёт вопрос. Он перекладывает на тебя работу по формулированию собственной проблемы. То есть предлагает тебе сначала догадаться, что именно ему непонятно, а потом ещё и объяснить.
Помогать хочется тому, кто уже что-то сделал. «Прочитал про методы, понял GET и POST, но не понял, чем PUT отличается от PATCH - вот тут написано так, а на практике вижу так» - на такое ответят с удовольствием, потому что видно, что человек шевелился.

Как собирать вопрос, чтобы работало

Схема простая, из четырёх кусков.

- Контекст.
Где ты, что за окружение, под кем сидишь, какая версия. Без этого любой ответ - гадание.

- Что делал.
Конкретные шаги, а не «пытался разобраться».

- Что получил.
Точная формулировка ошибки, код ответа, скрин. Не пересказ своими словами, а как есть.

- Что уже проверил.
Самый недооценённый пункт. Он экономит человеку время и сразу показывает, что ты не халявщик. Плюс отсекает половину встречных вопросов в стиле «а в инкогнито пробовал?».

- И только потом сам вопрос.
Желательно конкретный: не «что делать», а «это баг фронта или бэка» / «стенд лежит или я криво зашёл».

Побочный эффект, ради которого всё и затевалось

Самое смешное начинается, когда ты садишься писать по этой схеме.
Пока ты формулируешь контекст, шаги, ошибку и то, что уже проверил - вопрос примерно в половине случаев отпадает сам. Ты просто впервые раскладываешь ситуацию по полочкам и на третьем пункте понимаешь: блин, я же не на том стенде сижу.

Это называется «эффект резинового утёнка» - когда программисты объясняют проблему игрушке на столе и по ходу объяснения сами находят решение. Тебе даже утёнок не нужен, у тебя есть поле ввода в телеге.

Так что даже неотправленный вопрос, написанный правильно - это уже польза.

И про то, кому ты пишешь

Ещё пара мелочей, которые сильно влияют.
Пиши в общий чат, а не в личку, если вопрос не персональный. В личке ответит один человек и когда сможет. В чате ответит тот, кто свободен - и заодно ответ останется для следующего, кто придёт с тем же.

Не пиши десяти людям одновременно одно и то же. Это чувствуется, и это неприятно.
И не тяни до последнего. Сидеть три дня и молча страдать, чтоб не показаться глупым - худшая стратегия из существующих. Глупым ты покажешься как раз в конце спринта, когда выяснится, что задача не сделана, а ты обосрался.

Какая мораль? 🫰

Не будь мудаком и пойми, что хорошо заданный вопрос - это не про вежливость, это про уважение к чужому времени. Ты не «отвлекаешь человека», ты либо экономишь ему пять минут, либо отжираешь полчаса - и от этого зависит, захочет ли он помогать тебе в следующий раз.

А репутация человека, которому не влом разобраться перед тем, как спросить, окупается вообще везде. И на проекте, и на собесе, и в жизни.