
网站简介
该网站是《提问的智慧》(How To Ask Questions The Smart Way)的中文翻译版页面,部署在GitHub Pages上。原作由Eric S. Raymond和Rick Moen撰写,中文版由D.H.Grand、Gasolin、Ryan Wu等人翻译维护。该文档自2001年发布以来,已成为黑客文化和开源社区中关于“如何提问”的经典指南,被无数技术论坛、项目文档和团队规范引用。
主要功能/内容
网站主体就是《提问的智慧》全文,包括以下核心章节:
- 声明 —— 明确本指南不提供实际项目支持服务,防止读者产生误解。
- 简介 —— 说明提问方式直接决定能否获得有用回答,指出黑客喜爱有挑战性的问题,而讨厌不愿思考、只求索取的“失败者”。
- 在提问之前 —— 建议提问者先自行尝试、阅读文档、搜索网络,充分准备后再提问。
- 当你提问时 —— 这是全书最长的部分,详细给出了几十条具体建议,包括:慎选提问论坛(如Stack Overflow、IRC、项目邮件列表);使用有意义且描述明确的标题;使问题容易回复;使用清晰、正确、精准并合法语法的语句;使用易读取的标准文件格式发送问题;精确描述问题症状而非猜测;话不在多而在精;别动辄声称找到Bug;低声下气不能代替功课;按发生时间先后列出问题症状;描述目标而非过程;别要求使用私人电邮回复;清楚明确表达问题和需求;询问代码问题时注意适当抽象;别把家庭作业贴上来;去掉无意义的提问句;不要在标题写“紧急”;礼貌且不要忘记感谢;问题解决后加简短补充说明。
- 如何解读答案 —— 包括RTFM和STFW的含义,如何处理无礼的回应,如何避免扮演失败者,列出“不该问的问题”,区分“好问题与蠢问题”,如果得不到回答该怎么办,以及如何更好地回答问题。
- 相关资源与鸣谢 —— 给出外部链接和致谢。
特点说明
- 经典权威:原作者Eric S. Raymond是著名黑客,该文经过多次修订(3.10版),具有极强的说服力和影响力。
- 可操作性强:每条建议都具体明确,例如“用清晰、正确、精准并合法语法的语句”“按发生时间先后列出问题症状”等,读者可直接应用。
- 文化教育意义:该指南不仅讲技术提问技巧,还传递了开源社区的行为准则和价值观,如独立思考、尊重他人时间、分享回报等。
- 中文翻译质量高:中文版由多位译者协作完成,并注明翻译版本与原文出处,方便对照阅读。
- 访问便捷:通过GitHub Pages免费托管,无需注册即可阅读,适合所有技术学习者和社区参与者。
总之,这是一个极具学习价值的信息型网页,是每位技术爱好者在寻求帮助前值得阅读的“教科书”。