Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update 9.0-how_to_ask.md #36

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -1,86 +1,58 @@
# 如何优雅地提问
# 如何获取售后技术支持

### 1 在各个地方提问时,大家会发现有几个现象:
尊敬的大象机器人用户,

* 提问题后没人回答
* 提的问题过了很久才有人回答
* 对方老是嫌弃自己太菜
当您遇到产品使用上的疑问时,我们的技术支持团队随时准备为您提供帮助!

为了确保您能够获得快速而有效的解决方案,我们建议您在联系我们的技术支持团队之前,先浏览我们的gitbook产品资料库和常见问题解答(FAQ)部分。这些资料通常包含了丰富的产品信息和针对常见问题的解决方法,您很可能通过这些资源自行找到答案,从而迅速解决问题。

### 2 问问题前,确认自己已经学习了文档中驱动相关、软件相关与硬件相关的章节
如果您已经查阅了这些资料但问题仍未解决,或者需要更进一步的帮助,请按照以下格式详细描述您的问题,我们将竭尽所能为您提供协助。

文档中驱动相关、软件相关与硬件相关的章节,是使用 **my系列** 的基础中的基础,不管你是否有过开发经验,是大佬还是小白,请务必从前到后完整阅读并操作一遍。
感谢您的理解与合作!

很多问题会在这个过程中解决,切忌一开始就到 QQ群、论坛 、issue, 或者邮件随便提问,很多在文档中一开始就说明了的问题可能不会得到社区的及时的回答,节省大家的时间,也为了更好的社区环境,大家共同更好地成长,请互相理解。
## 产品使用提问模板参考如下:

1. **请提供大象机器人的产品订单编号并描述具体产品机型,订单编号是获取售后服务的关键,它帮助我们快速定位您的订单信息和产品记录**
- 例如:我的订单编号是:#xxxxxx,购买的机型是:mycobot280M5

### 3 提问时,尽量做到以下几点,会大大提高问题被快速解决的几率:
2. **尽可能详细描述你遇到的问题是什么,正在参考的 gitbook 具体案例或其他资料是哪些**
- 例如:我的 mycobot280M5 在使用 gitbook 教程第 6 章 myblockly 控制关节时,弹出报错
信息,显示无法通讯,请问我应该怎么解决?

#### 缕清问题,弄清楚到底发生了什么,以及我做了什么,包括:
3. **描述目前你已经做了什么尝试,对应的效果是什么,想要达到的效果是什么**
- 例如:我目前已经尝试查看了常见问题解答文档,烧录了 Atom6.5 版本的固件,但是仍然出
现同样的报错信息,我想知道是否有什么方法完美解决这个报错,让我的程序运行起来

* 我想实现什么效果,什么功能?
4. **尽量提供一些问题相关的图片或视频细节,以便技术人员快速定位问题。**
- 例如:下面是我的控制代码及报错信息,请协助我进行分析,谢谢。

* 为了实现这个效果,我是怎么做的,详细的过程是什么?
**注意**,如有多个问题,请罗列分点提问。

* 实施的过程中,什么错误发生了,现象是什么(比如报错了,报了什么错,**完整**的错误内容是什么?)
例如:

* 我是否认真看了报错的信息,报错信息中是否有提示了错误的原因和解决的方法?
- 您好,我的订单编号是:SP#xxxxxx,购买的机型是:mycobot280M5
- 我有三个问题需要您协助回答,问题如下:
- 第一个问题是 xxx
- 详细描述+附图片或视频细节
- 第二个问题是 xxx
- 详细描述+附图片或视频细节
- 第三个问题是 xxx
- 详细描述+附图片或视频细节

* 根据这些报错信息,仔细思考,是否能解决问题?
感谢您的支持与帮助!

* 搜索文档、issue,以及用搜索引擎能不能搜索到问题的解决方法?
如果遇到产品使用问题,请尽量按照以上格式提问,这样将会有助于技术支持人员快速定位并
协助您解决问题,感谢您的支持与配合,祝您产品使用顺利!

### 4 如果问题自己实在不能解决,需要请教于人,需要考虑:
## 联系方式

* 请教谁,在哪里请教,谁会更有几率回答我的问题?以及实时性如何?
- **大象售后技术支持微信联系方式**:ElephantRobotics 2020
- **大象售后技术支持邮箱联系方式**:[email protected]

* 我应该给他提供什么数据和现象他才能愿意快速帮我解决问题?
* 提供我的目的(方便让回答者知道你在做什么事情)
* 提供完整的实施过程,以及过程中出现的现象(方便回答者跟着你的流程去做一遍,即问题复现)
* 给出错误的地方,指明哪里出现的现象或结果和自己预期的不一样!(让回答者知道,哪里没达到预期)
* 提供出现的错误信息,需要完整,尽可能更多地截图,更多的日志,千万别小气地截一张小图,或者之给出日志的一部分(因为回答者可能很久没做这件事情了,忘记了一些细节,需要靠截图和完整日志来快速回忆起来;而且根据详细的日志可以快速定位到问题处在哪里)
## 工作时间

* 怎么提问态度显得比较诚恳,就算我再小白,大家也愿意回答
北京时间周一至周五 9:00-18:00,法定节假日正常休息。

### 5 提问模板
**注意事项**:如果您没有大象机器人的产品订单编号,这通常意味着您并非通过我们的官方直销渠道购买的产品。
在这种情况下,我们建议您直接联系您购买产品的平台或经销商,以获取相应的售后服务和支持。我们感谢您的理解,并希望您能够顺利解决问题。


提问尽量做到提问优雅,不需要添加多余的语气词,抱怨的词汇,斟酌每一个词和标点符号,站在回答人的角度思考问题,如何让回答的人快速帮助自己解决问题,字数太少描述不清楚,字数太多则让人没有耐心。

### 6 标题

无论在哪里提问(包括`QQ群`),给自己的问题拟定一个`30`个字左右标题,阐明问题的中心思想,包括:
* 问题类别,是问题请教,还是 BUG提交,还是经验分享等等。让大家在满是文字的屏幕上可以立马定位到你想做什么
* 一句话阐明问题的中心你思想,比如 `运行摄像头示例程序,报错 reset fail,可能是硬件问题`

所以综合后标题可以是这样:
* `【mycobot 提问】 运行摄像头示例程序,报错 reset fail,可能是硬件问题吗`

这样的标题尽量**不要**出现:
* `啊啊啊啊啊为什么我的板子又不行了`
* `为什么我的代码不能运行了`
* `为什么我的屏幕黑屏了`
* `【mycobot 提问】 收到了开发板,开发板屏幕是红的,一行小字,为什么呢`
* `我运行xxx程序,出了问题`

可以这样问:
* `【mycobot 提问】 我的板子在我接反电源后,现在板子无法启动,怎么判断板子哪里烧毁了,如果可以,怎么救活呢`

### 7 内容

首先站在回答者的角度,如果被问问题:
* 首先要知道对方要做什么,实现什么目标
* 为了实现这个目标,他是参考了哪里的步骤做的
* 实际上采用了哪些具体的步骤,然后在那一步出现了问题,方便我照着他的步骤去尝试复现一下现象。如果这个问题看起来不好解决,又没有复现的步骤,那可能要花很多时间去复现,先放一放先解决其它问题吧
* 具体出现的问题是什么,如果他只说出了问题,我怎么知道他出了什么问题,也许是身体不适?所以这很重要,需要让他说明出问题时的现象,并指明与预期有什么不同,不然我还得去猜去对比和预期有什么不同,解决问题的时长又增加了
* 出问题了,我可能需要他的日志文件,方便我根据日志去看源码等进行分析,不然可能会很难解决问题,那这个问题可以放到后面慢慢看吧

综上,可以这么提问:

* 详细阐明自己的目标,想做什么事情,现象应该是什么样的
* 我有没有参考哪里的文档、代码或者教学
* 如何复现错误:具体怎么做的,每一个步骤写详细,直到问题出现
* 详细阐述错误出现时的现象,以及和期望的相比哪里不一样,需要证明问题确实出现了
* 附带日志文件,以及截图,甚至是视频,日志和截图一定要完整,不要只截取一小部分,回答者可能会从你的完整日志和截图中发现一些你没注意到的问题,这很重要
* 另外,粘贴代码注意格式,别粘贴后显示很乱,无法入目,尽量能复制后直接能运行
* 最后,对解答问题的社区朋友们表达感谢