Перейти к основному содержимому

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

  • 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, но никаких устройств не найдено.