如何避免无效的沟通（二）

2023-03-22

本文主要讨论最近一次发生的具有代表性的无效沟通。

本文中隐去了个人信息和敏感信息，行文略作调整以方便说明问题

0. 相关文章

如何避免无效的沟通（一）

1. 事情经过

某日，同事 A 在公司问答系统中提了一个问题，全文如下：

k8s 安装 DCA 后报错：请检查 DataKit 的 token 是否正确

是哪个 SaaS 站点或者部署版
  广州 SaaS
  datakit 1.5.7

错误描述
  见截图

接到问题的同事 B 完全看不懂想要表达什么，觉得浪费了他的时间。于是有了如下对话：

同事 A 同事 B 这个 FAQ 能不能加一点文字描述？不熟悉细节的，压根不知道那个红框到底要表达什么意思。 哪里不清晰了？ 你只是描述了一个客观存在的报错，这个报错如果不合理，请给出你期望的方式。从截图来看，「请检查 token 是否正确」，这肯定是一个有意的设定。如果你提供了正确的 token，请给出证据（比如 XXXX 的截图），如果觉得这个设计不合理，请给出你的方案。

2. 点评

「提问题」首先得保证确实「提出了问题」。

本案例中的同事 A 仅仅截了几张图片，完全没有「提出问题」，同事 B 看不懂是必然的。

我们在提问时，应当假设对方完全不了解事情全貌，必要的前因后果需要阐述清楚，比如：

• 我在做什么？
• 提供的材料（截图、日志等）是什么？
• 我期望 / 预期达到什么效果？
• 实际出现的是什么？

一个典型的让人摸不着头脑的例子：

提问者 回答者 Exception: request timeout 这是怎么回事？ 这没头没尾的看不懂！

正确的、完整的提问方式应该像下面这样：

提问者 回答者 我在调用 XXX 系统的 POST /modify-workspace 接口，但是发生了下面的报错 Exception: request timeout 完整的请求如下： POST /modify-workspace
{
  "data": {
    "name": "开发测试一起用"
  }
} 好的，我看一下

大家在工作上的沟通交流，特别是在提问时，切不可一时偷懒，就提出不完整的提问。

虽然在提问时可能节约了几分钟时间，但是回答者看不懂问题，还是需要反复确认，总体而言并不会节约时间，反而会浪费双方的时间，得不偿失。

希望大家能够通过本文有所收获！