一篇写给 TDengine 用户的提问指南
一篇写给 TDengine 用户的提问指南
在技术社区运营过程中,每天会遇到各种各样的用户提问,我们发现其中很多提问的方式不够科学合理或者高效。特此,我们撰写了这篇提问指南,希望能够帮助大家更科学、高效的进行交流。同时,本指南中的方法和建议也适用于绝大部分技术社区,有助于提高大家的整体提问水平。
⏱ 提问之前
在你准备要向 GitHub Issues、技术交流群、技术论坛中提出技术问题前,请先做到以下事情:
  • 尝试在你准备提问的论坛的历史帖子中搜索答案。
  • 尝试在网上搜索以找到答案。
  • 尝试自己检查或试验以找到答案。
  • 向你身边的强者朋友询问以找到答案。
  • 如果你是程序开发者,请尝试阅读源代码以找到答案。
当你提出问题的时候,请先让别人看起来你已经做了上述的努力;这将有助于展示出你并不是一个不劳而获且浪费别人时间的提问者。如果你能一并展现在做了上述努力的过程中所学到的东西会更好,因为我们更乐于回答那些表现出能从答案中学习的人的问题。
准备好你的问题,再将问题仔细的思考过一遍,因为草率的发问只能得到草率的回答,或者根本得不到任何答案。越是能表现出在寻求帮助前你为解决问题所付出的努力,你越有可能得到实质性的帮助。
小心别问错了问题。如果你的问题基于错误的假设,社区里的人多半会一边在心里想着蠢问题…,一边用无意义的字面解释来答复你,希望你会从问题的回答(而非你想得到的答案)中汲取教训。
绝不要自以为够格得到答案,你没有,你并没有。毕竟你没有为这种服务支付任何报酬。你将会是自己去挣到一个答案,靠提出有内涵的、有趣的、有思维激励作用的问题 —— 一个有潜力能贡献社区经验的问题,而不仅仅是被动的从他人处索取知识。
另一方面,表明你愿意在找答案的过程中做点什么是一个非常好的开端。谁能给点提示?我的这个例子里缺了什么?以及我应该检查什么地方请把我需要的确切的过程贴出来更容易得到答复。因为你表现出只要有人能指个正确方向,你就有完成它的能力和决心。
📔 尝试在文档中直接找到答案
在上述“提问之前”步骤中,我们已经提到过“尝试阅读官方文档以找到答案”这一条,在此再次特别提出,因为通常学习一门技术最简单的方法就是跟着官方教程走一遍,通过官方教程理解这个产品最基本的技术概念。如果要深入理解,就需要继续研究文档。
通常一份设计良好的文档中会包括如下几个部分:
教程 - 面向学习的方式
以最简单易懂的方式,让你快速了解产品的最基本用法。对应 TDengine 文档中的 立即开始
概念讲解 - 面向理解的方式