# 反馈问题

感谢你愿意将遇到的问题反馈给划词翻译、或是给划词翻译提供新的功能提议!请按照如下步骤反馈问题。

# 检查问题是否已经有人提出来过了

在提出问题之前,请先在划词翻译的工单列表里搜索一下,是否已经有人提出相同的问题了。如果有,你可以注册一个 GitHub 账号,在工单下添加你的回复。

为什么?

截止 2020 年 4 月 27 日,在划词翻译的 626 个工单中,有 118 个重复的工单占工单总数的 19%,这花费了我们很多不必要的时间。

# 如果你是想提出一个问题

请按照如下的格式提出你的问题:

TIP

提问者:我使用的是 Chrome 80.0.3987.163 和划词翻译 6.4.9(提供版本号),今天我发现 PDF 翻译功能不能用了。重现问题的步骤如下(提供重现步骤):

  1. 打开某网站 http://xxx.xxx
  2. 登录之后搜索“xxx”,在搜索页点击“下载 PDF”,此时 Chrome 浏览器会打开这个 PDF 文件

预期行为:划词翻译在 PDF 文件内应该可以正常使用。

实际行为:在 PDF 中划词后,没有弹出划词翻译的按钮。(用对比的方式说明问题所在

:我使用你的步骤重现你的问题了,我会在近期发布一个新版本解决你的问题。

如果没有按照上面的格式提出问题,那么我们的沟通会变成下面这样:

WARNING

提问者:PDF 文件不能翻译了。

:我这边试了下是可以正常使用的,能提供你的浏览器版本、划词翻译版本与重现问题的步骤吗?

(两天后)提问者:我用的 Chrome,划词翻译用的是最新版本

(一天后)我:我用 Chrome 和最新版本划词翻译试着打开了一个 PDF 文件,是能正常使用的,你是用了什么 PDF 不能使用,是本地的 PDF 还是在线的 PDF?我使用什么步骤能接触到你出现问题的 PDF 文件?

...

反馈问题时最好能附上相关文件,例如截图或者不能正常翻译的 PDF 文件。我们会优先处理有详细重现步骤的问题。

# 如果你是想提议一个新功能或功能改进

在提出新功能/功能改进时,除了描述功能本身,也请告诉我们为什么你觉得有改进的必要。

举个例子:

好的提出方式

提问者:希望鼠标移动到翻译按钮上时,不需要点击就能弹出翻译面板。因为我在 xxx 使用(说明使用场景)时,这样做能帮助我 xxx(说明改进之后能带来什么好处)...

:我明白你的意图了,我会在下一个版本中添加这个功能。

如果没有提供改进的原因,我们的沟通就会像下面这样:

不好的提出方式

提问者:希望鼠标移动到翻译按钮上时,不需要点击就能弹出翻译面板

:为什么要省掉这一次点击?

(两天后)提问者:因为 xxx...

(一天后)我:那这样是不是可以... ...

# 反馈渠道

划词翻译提供了三种反馈渠道。

# 提交工单(推荐)

划词翻译的源代码托管在 GitHub 里,我们建议直接打开 GitHub 的工单系统,点击“New Issue”提交新的工单。

我们主要使用这个渠道收集大家的反馈,并将进度更新在里面。

但是,使用 GitHub 的工单系统需要你创建一个 GitHub 的账号,并且 GitHub 在国内偶尔会打不开,所以我们还提供了下面两种反馈方式。

# 在公众号里反馈

你可以关注划词翻译的公众号“划词翻译”,直接给公众号发送消息即可。

# 使用邮件反馈

你可以发送邮件给 me@limingkai.cn 反馈问题,我会定期查看邮箱并回复。