《如何提问》阅读笔记

提问的智慧

提问之前的准备

检索现有资料

在所有可能找到答案的地方

  • 搜索引擎
  • 手册
  • FAQ
  • 自己检查
  • 向身边朋友询问
  • 阅读源代码

做好提问的准备

  • 组织好提问语言
    • 精炼表述自己遇到的问题
    • 表达清楚自己所做的尝试
  • 准备好报错信息

在提问时

利用好 Stack Overflow

  • 在使用之前进行 Google 搜索
  • 在网站内部使用 Tag 等辅助搜索方式

论坛提问

  • 仔细阅读论坛 FAQ,谨慎选择提问的论坛,不要在论坛提出不合适的问题
  • 谨慎向私人或者论坛发送邮件

邮件列表求组

  • 尽量向使用者或者维护者提问
  • 使用有意义且描述明确的标题:目标 - 差异
    • 目标:哪一部分或哪一组东西有问题
    • 差异:哪些部分与期望不一致
  • 认证对待语句,使用正确、清晰及精准的描述
  • 文件格式发送问题:
    • 使用纯文本,不要使用封闭格式编写的文档
    • 数据应该要保持原样
    • 不要滥用表情符号和 HTML 其他功能

有效的报告 Bug

  • 仔细描述问题或者 Bug 症状
  • 附带 bug 运行环境:机器邮件配置、操作系统版本以及应用程序版本
  • 复述已经进行的操作尝试,以及你对问题的理解和研究
  • 确定问题的诊断步骤
  • 近期做过的可能引起 bug 的软件或硬件变更
  • 提供可复现 bug 的环境和方法

描述清楚问题

  • 按时间先后列出问题症状
  • 先列出你的目标,再讲清楚你的过程
  • 询问代码相关问题时:精简代码,提供最精简的测试用例
  • 去掉无意义的语句
  • 不要用 紧急 等词汇
  • 尽量礼貌
  • 问题解决后增加补充说明

合理使用搜索引擎