Прочтите перед заданием вопроса

• QQ/WeChat и другие инструменты общения предоставляют быстрый и удобный способ общения, но если у вас возникли проблемы, рекомендуется следовать следующим шагам.
• В конечном итоге получение полезного ответа во многом зависит от того, как вы формулируете вопрос и задаете уточняющие вопросы.

Шаги решения проблемы:

1. Попробуйте решить проблему самостоятельно: используйте свои знания для попытки самостоятельного решения проблемы. Не бойтесь английских сообщений об ошибках, постарайтесь понять их содержание. Большинство сообщений об ошибках имеют указательные элементы, вам нужно просто найти их и попробовать решить проблему самостоятельно.
2. Поиск в интернете: проверьте, не сталкивались ли другие люди с подобной проблемой. Если да, обратитесь к их решениям, если нет, задайте вопрос в группе.
3. Задайте вопрос в группе: при задании вопроса в группе опишите проблему ясно и приложите скриншоты для быстрого выявления проблемы. Чем больше информации вы предоставите, тем эффективнее будет работа над решением.

Для повышения вероятности быстрого решения вашей проблемы, старайтесь придерживаться следующих рекомендаций:

Мысленно ставьте себя на место того, кто отвечает на ваш вопрос

При каждом вопросе ставьте себя на место человека, который отвечает:

• Предположим, что все ответчики — это эксперты, у которых очень мало времени.
• Как сделать так, чтобы мой вопрос был понятен за один взгляд? Лучше избегать ситуации, когда ответчик должен уточнять, что я делал, зачем это было нужно и т.д.
• Почему людям будет интересно ответить на мой вопрос? Это связано с технической глубиной обсуждения, чувством важности моего вопроса или возможностью получить материальную награду?
• Избегайте того, чтобы ответчик думал, что я ленивый, не читал документацию, код, журналы, не искал информацию в интернете, не размышлял и не пытался решить проблему самостоятельно.

Упорядочьте проблему, разберитесь, что именно произошло и что вы сделали, включая:

• Что вы хотите достичь, какую функциональность реализовать?
• Какими были ваши действия для достижения этого результата, какие были детали процесса?
• Что за ошибки возникли в процессе, каковы их проявления (например, возникла ошибка, какое именно сообщение об ошибке, полное содержание сообщения об ошибке? Старайтесь не ограничиваться последними строками, посмотрите полные журналы)?
• Было ли внимательно прочитано сообщение об ошибке, есть ли в нем указания на причину и способ решения?
• После анализа сообщений об ошибках, тщательно подумайте, сможете ли вы решить проблему?
• Проверьте документацию, часто задаваемые вопросы, вопросы в issue и используйте поисковые системы для поиска способов решения проблемы.
• Если что-то в документации кажется неполным, прямо укажите на это! Не беспокойтесь, я не эксперт, возможно, где-то я недоработал.

Недостаточно эффективные или даже бесполезные вопросы

• Вопрос: Прошу помощи у гуру, как решить эту проблему?

Проблемы в таком подходе:

• Любительские снимки экрана Если можно сделать скриншот, то лучше не использовать фотоаппарат. Используйте инструменты для создания скриншотов. Исключение — только в особых случаях, когда нужно сделать четкое фото.
• Недостаток информации Проблема с отсутствием CAN ID может быть вызвана множеством причин, таких как неправильное подключение, различная скорость между главным устройством и периферийным устройством и т.д. Ограничьте свою проблему конкретной ситуацией, предоставьте точные условия, чтобы сосредоточиться на проблеме.
• Без знания работы со скриншотами этот урок по созданию скриншотов

Шаблон для постановки вопроса

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

Если вы не можете решить проблему самостоятельно, подумайте:

• К кому обращаться, где лучше спрашивать, кто имеет больше шансов ответить на ваш вопрос, и какова степень срочности?

• Какую информацию и явление вы должны предоставить, чтобы человек мог быстро вам помочь?

  • Вашу цель (чтобы ответчик знал, чем вы занимаетесь)
  • Полный процесс выполнения задачи и явления, которые возникают на этапах (чтобы ответчик мог повторить ваш процесс и воспроизвести проблему)
  • Укажите места, где результаты отличаются от ваших ожиданий (чтобы ответчик знал, где возникла проблема)
  • Предоставьте информацию об ошибках, желательно полную, с максимальным количеством скриншотов и журналов. Не жалейте делать полные скриншоты или показывать только часть журнала (ответчик может давно не заниматься этим, ему нужно полный журнал для быстрого восстановления деталей; также детальные журналы помогают быстро выявить проблему).

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

Заголовок

В любом месте, где вы задаете вопрос, составьте заголовок своей проблемы объемом около 30 слов, чтобы объяснить основную мысль, включая:

• Категория проблемы, это вопрос, баг-репорт или обмен опытом и т.д. Дайте возможность другим сразу понять, что вы хотите сделать.
• Одним предложением объясните основную мысль проблемы, например, возникла проблема с "отсутствием CAN ID", "неподключенной материнской платой" и т.д.

Таким образом, заголовок может выглядеть так:

• `【Вопрос】Не удается найти CANID на SHT36V3, уже проверил все, что..."

Такие заголовки не должны содержать:

• Ах, ах, ах, почему моя плата не находит ID (я не знаю, как вы подключались и что делали, я не в курсе).
• Почему мой хост не запускается (я не знаю, какой хост, вообще ничего не понятно).
• У меня нет устройства (я не знаю, что за продукт).
• Что за ошибка вылезла (не читал документацию, сразу спрашиваю).
• Получил материнскую плату, как подключать драйвер (не читал документацию, сразу спрашиваю).
• Как подключить эту проводку (что за проблема?).
• Почему после входа в DFU не могу записать, почему не могу войти в DFU и т.д. (нужно рассказать, как вы действовали, как подключали, иначе могут подумать, что вы бессмысленно говорите, и игнорировать вас).

Можно задавать вопросы так:

• 【Вопрос】После подключения питания в обратном направлении, моя плата не запускается. Как определить, где она вышла из строя? Если возможно, как её восстановить?
• 【Баг】Эта часть документации не до конца раскрыта, хотелось бы добавить или изменить подобное описание

Пример шаблона

• Пожалуйста, потратьте немного времени на формулировку вопроса, опишите следующую информацию:
• В конечном итоге получение полезного ответа во многом зависит от того, как вы формулируете вопрос и задаете уточняющие вопросы.

1. Какая проблема Например: Новая материнская плата и инструмент не находят устройства.
2. Какое оборудование используется Например: ТВ-бокс + D5 материнская плата + SHT36V3.
3. Как подключены провода Например: Высококачественные фотографии подключения отправьте экспертам.
4. Какие симптомы проблемы Например: Хост вводит команду lsusb и не видит устройств. Приложите полные снимки экрана.

【Вопрос】Купил D5 материнскую плату и SHT36, подключил к хосту с использованием lsusb, но никаких устройств не найдено.