ryanhanwu /How-To-Ask-Questions-The-Smart-Way
本文原文由知名 Hacker Eric S. Raymond 所撰寫,教你如何正確的提出技術問題並獲得你滿意的答案。
★ 36,129⑂ 5,819👁 415⑃ 111● 30▤ 0
+1
Daily
+54
Weekly
+224
Monthly
36,129
stars
5,819
forks
415
watchers
111
prs
30
issues
0
releases
README
提問的智慧
How To Ask Questions The Smart Way
Copyright © 2001, 2006, 2014 Eric S. Raymond, Rick Moen
本指南英文版版權為 Eric S. Raymond, Rick Moen 所有。
原文網址 (Translated from):http://www.catb.org/~esr/faqs/smart-questions.html
Copyleft 2001 by D.H.Grand(nOBODY/Ginux), 2010 by Gasolin, 2015-present by Ryan Wu
本中文指南是基於原文 3.10 版以及 2010 年由 Gasolin 所翻譯版本的最新翻譯;
協助指出翻譯問題,__請發 issue,或直接發 pull pequest 給我。__
本文另有:简体中文版
原文版本歷史
目錄
聲明
簡介
在提問之前
當你提問時
慎選提問的論壇
Stack Overflow
網站和IRC論壇
第二步,使用專案郵件列表
使用有意義且描述明確的標題
使問題容易回覆
用清晰、正確、精準並合乎文法的語句
使用易於讀取且標準的文件格式發送問題
精確的描述問題並言之有物
話不在多而在精
別動輒聲稱找到Bug
別用低聲下氣取代你真正該做的事
描述問題症狀而非猜測
按發生時間先後列出問題症狀
描述目標而不是過程
別要求使用私人電郵回覆
清楚明確地表達你的問題以及需求
詢問有關程式碼的問題時
別把自己家庭作業的問題貼上來
去掉無意義的提問句
即使你很急也不要在標題寫緊急
禮多人不怪,而且有時還很有幫助
問題解決後,加個簡短的補充說明
如何解讀答案
RTFM和STFW:如何知道你已完全搞砸了
如果還是搞不懂
處理無禮的回應
如何避免扮演失敗者
不該問的問題
好問題與蠢問題
如果得不到回答
如何更好地回答問題
相關資源
鳴謝
聲明
許多專案在他們的使用協助/說明網頁中連結了本指南,這麼做很好,我們也鼓勵大家都這麼做。但如果你是負責管理這個專案網頁的人,請在超連結附近的顯著位置上註明:
__本指南不提供此專案的實際支援服務!__
我們已經深刻領教到少了上述聲明所帶來的痛苦。因為少了這點聲明,我們不停地被一些白痴糾纏。這些白痴認為既然我們發布了這本指南,那麼我們就有責任解決世上所有的技術問題。
如果你是因為需要某些協助而正在閱讀這本指南,並且最後離開是因為發現從本指南作者們身上得不到直接的協助,那麼你就是我們所說的那些白痴之一。別問我們問題,我們只會忽略你。我們在這本指南中是教你如何從那些真正懂得你所遇到軟體或硬體問題的人取得協助,而99%的情況下那不會是我們。除非你確定本指南的作者之一剛好是你所遇到的問題領域的專家,否則請不要打擾我們,這樣大家都會開心一點。
簡介
在駭客的世界裡,你所提技術問題的解答的好壞, 很大程度上取決於你提問的方式與此問題的難度。本指南將教你如何正確的提問以獲得你滿意的答案。
現在開放原始碼(Open Source)軟體已經相當盛行,您通常可以從其他更有經驗的使用者那裡獲得與駭客一樣好的答案,這是件好事;和駭客相比,使用者們往往對那些新手常遇到的問題更寬容一些。儘管如此,以我們在此推薦的方式對待這些有經驗的使用者通常也是從他們那裡獲得有用答案的最有效方式。
首先你應該明白,駭客們喜愛有挑戰性的問題,或者能激發他們思維的好問題。如果我們並非如此,那我們也不會成為你想詢問的對象。如果你給了我們一個值得反覆咀嚼玩味的好問題,我們自會對你感激不盡。好問題是激勵,是厚禮。好問題可以提高我們的理解力,而且通常會暴露我們以前從沒意識到或者思考過的問題。對駭客而言,"好問題!"是誠摯的大力稱讚。
儘管如此,駭客們有著蔑視或傲慢面對簡單問題的壞名聲,這有時讓我們看起來對新手、無知者似乎較有敵意,但其實不是那樣的。
我們不諱言我們對那些不願思考、或者在發問前不做他們該做的事的人的蔑視。那些人是時間殺手──他們只想索取,從不付出,消耗我們可用在更有趣的問題或更值得回答的人身上的時間。我們稱這樣的人為 失敗者(loser) (由於歷史原因,我們有時把它拼作 lusers)。
我們意識到許多人只是想使用我們寫的軟體,他們對學習技術細節沒有興趣。對大多數人而言,電腦只是種工具,是種達到目的的手段而已。他們有自己的生活並且有更要緊的事要做。我們認可這點,也從不指望每個人都對這些讓我們著迷的技術問題感興趣。盡管如此,我們只為那些真正有興趣並願意積極參與問題解決的人調整回答問題的風格。這點不會變,也不該變:否則,我們就是在最擅長的事情上降低效率。
我們(在很大程度上)是自願的,從繁忙的生活中抽出時間來解答疑惑,而且時常被提問淹沒。所以我們無情的濾掉一些話題,特別是拋棄那些看起來像失敗者的傢伙,以便更高效的利用時間來回答贏家(溫拿)的問題。
如果你厭惡我們的態度,高高在上,或過於傲慢,不妨也設身處地想想。我們並沒有要求你向我們屈服──事實上,我們大多數人非常樂意與你平等地交流,只要你付出小小努力來滿足基本要求,我們就會歡迎你加入我們的文化。但讓我們幫助那些不願意幫助自己的人是沒有效率的。無知沒有關係,但裝白痴就是不行。
所以,你不必在技術上很在行才能吸引我們的注意,但你必須表現出能引導你變得在行的特質──機敏、有想法、善於觀察、樂於主動參與解決問題。如果你做不到這些使你與眾不同的事情,我們建議你花點錢找家商業公司簽個技術支援服務契約,而不是要求駭客個人無償地幫助你。
如果你決定向我們求助,當然你也不希望被視為失敗者,更不願成為失敗者中的一員。能立刻得到快速並有效答案的最好方法,就是像贏家那樣提問──聰明、自信、有解決問題的思路,只是偶爾在特定的問題上需要獲得一點幫助。
(歡迎對本指南提出改進意見。你可以 email 你的建議至 [email protected] 或 [email protected]。然而請注意,本文並非網路禮節的通用指南,而我們通常會拒絕無助於在技術論壇得到有用答案的建議。)
在提問之前
在你準備要透過電子郵件、新聞群組或者聊天室提出技術問題前,請先做到以下事情:
1. 嘗試在你準備提問的論壇的舊文章中搜尋答案。
2. 嘗試上網搜尋來找到答案。
3. 嘗試閱讀手冊來找到答案。
4. 嘗試閱讀常見問題文件(FAQ)來找到答案。
5. 嘗試自己檢查或試驗來找到答案
6. 向你身邊的強者朋友打聽來找到答案。
7. 如果你是程式開發者,請嘗試閱讀原始碼來找到答案
當你提出問題的時候,請先表明你已經做了上述的努力;這將有助於樹立你並不是一個不勞而獲且浪費別人的時間的提問者。如果你能一