adjust wording

This commit is contained in:
Jerry Lee
2015-09-10 00:09:32 +08:00
parent 1de74a8585
commit 48f6c0b620

View File

@@ -124,7 +124,7 @@
有时,我们看起来还对新手和愚蠢的家伙有条件反射式的无礼,但事情并不真是这样。
我们只是毫无歉意地敌视那些提问前不愿思考、不做自己家庭作业的人。
这种人就象时间无底洞──他们只知道索取,不愿意付出,他们浪费了时间,这些时间本可用于其它更有趣的问题或更值得回答的人。
这种人就象时间无底洞 —— 他们只知道索取,不愿意付出,他们浪费了时间,这些时间本可用于其它更有趣的问题或更值得回答的人。
我们将这种人叫做 “失败者loser由于历史原因我们有时将“loser”拼写为“lusers” 。)
我们意识到许多人只是想使用我们写的软件,他们对学习技术细节没有兴趣。对大多数人而言,计算机只是种工具,是种达到目的的手段而已。
@@ -175,7 +175,7 @@
注意别提错问题。如果提问基于错误的假设,某黑客多半会一边想 “愚蠢的问题……”,一边按将错就错的答案回复你,并且希望这种只是得到你自己“问的问题”而非真正所需的解答,给你一个教训。
永远不要假设你 _有资格_ 得到解答。你没有这种资格,毕竟你没有为此服务付费。
如果你能够提出有内容、有趣和激励思考的问题──那种毫无疑问能够向社区贡献经验,而不仅仅是消极地要求从别人那获取知识的问题,你将“挣到”答案。
如果你能够提出有内容、有趣和激励思考的问题 —— 那种毫无疑问能够向社区贡献经验,而不仅仅是消极地要求从别人那获取知识的问题,你将“挣到”答案。
另一方面,表明你有能力也乐意参与问题的解决是个很好的开端。“有没有人能指个方向?”,我这还差点什么?”,“我应该查哪个网站?”,
通常要比 “请给出我可以用的完整步骤”更容易得到回复,因为你表明了只要有人能指个方向,你就很乐意完成剩下的过程。
@@ -197,7 +197,7 @@
因此第一步是找对论坛。谷歌和其它搜索引擎还是你的朋友可以用它们搜索你遇到困难的软硬件问题最相关的项目网站。那里通常都有项目的常见问题FAQ、邮件列表及文档的链接。
如果你的努力(包括 _阅读_ FAQ都没有结果这些邮件列表就是最后能取得帮助的地方。项目的网站也许还有报告臭虫的流程或链接如果是这样去看看。
向陌生的人或论坛发送邮件极有可能是在冒险。譬如,不要假设一个内容丰富的网页的作者想充当你的免费顾问,不要对你的问题是否会受到欢迎做太乐观的估计──如果你不确定,向别处发或者压根别发。
向陌生的人或论坛发送邮件极有可能是在冒险。譬如,不要假设一个内容丰富的网页的作者想充当你的免费顾问,不要对你的问题是否会受到欢迎做太乐观的估计 —— 如果你不确定,向别处发或者压根别发。
在选择论坛、新闻组或邮件列表时,别太相信名字,先看看 FAQ 或者许可书以明确你的问题是否切题。发贴前先翻翻已有的帖子,这样可以让你感受一下那里行事的方式。
事实上,张贴前在新闻组或邮件列表的历史文档中搜索与你问题相关的关键词是个极好的主意,也许就找到答案了。即使没有,也能帮助你归纳出更好的问题。
@@ -209,7 +209,7 @@
一般来说,在仔细挑选的公共论坛中提问比在私有论坛中提同样的问题更容易得到有用的回答。有几个道理支持这点,一是看潜在的回复者有多少,二是看论坛的参与者有多少,黑客更愿回答能启发多数人的问题。
可以理解,老练的黑客和一些流行软件的作者正在承受过多的不当消息。就象那根最后压垮骆驼背的稻草一样,
你的加入也有可能使情况走向极端──已经好几次了,一些流行软件的作者退出了对自己软件的支持,因为伴随而来的涌入其私人邮箱的垃圾邮件变得无法忍受。
你的加入也有可能使情况走向极端 —— 已经好几次了,一些流行软件的作者退出了对自己软件的支持,因为伴随而来的涌入其私人邮箱的垃圾邮件变得无法忍受。
### 面向新手的论坛和互联网中继聊天IRC通常响应最快
@@ -244,19 +244,21 @@
在邮件列表、新闻组或论坛中,主题是你在五十个或更少的字以内吸引有资格专家注意的黄金机会,不要用诸如 “请帮我” (更别提大写的 “请帮我!!!!”,这种主题的消息会被条件反射式地删掉)之类的唠叨浪费机会。
不要用你痛苦的深度来打动我们,相反,要在这点空间中使用超级简明扼要的问题描述。
使用主题的好惯例是“对象──偏差”(式的描述),许多技术支持组织就是这样做的。在“对象”部分指明是哪一个或哪一组东西有问题,在“偏差”部分则描述与期望的行为不一致的地方。
使用主题的好惯例是“对象 —— 偏差”(式的描述),许多技术支持组织就是这样做的。在“对象”部分指明是哪一个或哪一组东西有问题,在“偏差”部分则描述与期望的行为不一致的地方。
救命啊!我的笔记本视频工作不正常!
**愚蠢:**
> 救命啊!我的笔记本视频工作不正常!
**明智:**
X.org 6.8.1 扭曲鼠标光标MV1005 型号的某显卡芯片组
> X.org 6.8.1 扭曲鼠标光标MV1005 型号的某显卡芯片组
**更明智:**
使用 MV1005 型号的某显卡芯片组在 X.org 6.8.1 的鼠标光标被扭曲
> 使用 MV1005 型号的某显卡芯片组在 X.org 6.8.1 的鼠标光标被扭曲
编写 “对象──偏差”式描述的过程有助于你组织对问题的细致思考。是什么被影响了?仅仅是鼠标光标或者还有其它图形?
编写 “对象 —— 偏差”式描述的过程有助于你组织对问题的细致思考。是什么被影响了?仅仅是鼠标光标或者还有其它图形?
只在 X.org 中出现?或只是在其 6.8.1 版中?是针对某显卡芯片组?或者只是其中的 MV1005 型号?一个黑客只需描一眼就能够立即明白什么是你遇到的问题,什么是你自己的问题。
更一般地,想象一下在一个只显示主题的文档索引中查找。让你的主题更好地反映问题,可以使下一个搜索类似问题的人能够在文档中直接就找到答案的线索,而不用再次发贴提问。
@@ -283,7 +285,7 @@ X.org 6.8.1 扭曲鼠标光标MV1005 型号的某显卡芯片组
经验告诉我们,粗心与草率的作者通常也粗心与草率地思考和编程(我敢打赌)。为这些粗心与草率的思考者回答问题没有什么好处,我们宁可将时间花在其它地方。
清楚、良好地表达你的问题非常重要。如果你觉得这样做麻烦,我们也觉得注意(你的问题)麻烦。
花点额外的精力斟酌一下字句,用不着太僵硬与正式──事实上,黑客文化很看重能准确地使用非正式、俚语和幽默的语句。但它 _必须_ 很准确,而且有迹象表明你是在思考和关注问题。
花点额外的精力斟酌一下字句,用不着太僵硬与正式 —— 事实上,黑客文化很看重能准确地使用非正式、俚语和幽默的语句。但它 _必须_ 很准确,而且有迹象表明你是在思考和关注问题。
正确地拼写、使用标点和大小写不要将“its”混淆为“it's”“loose”搞成“lose”或者将“discrete”弄成 “discreet”。不要全部用大写这会被视为无礼的大声嚷嚷
全部小写也好不到哪去因为不易阅读。Alan Cox [注著名黑客Linux 内核的重要参与者] 也许可以这样做,但你不行。)
@@ -350,7 +352,7 @@ X.org 6.8.1 扭曲鼠标光标MV1005 型号的某显卡芯片组
提示:除非你能提供解决问题的源代码补丁,或者对前一版本的回归测试表现出不正确的行为,否则你都多半不够完全确信。
对于网页和文档也如此,如果你(声称)发现了文档的“臭虫”,你应该能提供相应位置的替代文本。
记住,还有许多其它用户并未经历你遇到的问题,否则你在阅读文档或搜索网页时就应该发现了(你在报怨前已经做了这些,[是吧](#before "Before You Ask") ?)。
记住,还有许多其它用户并未经历你遇到的问题,否则你在阅读文档或搜索网页时就应该发现了(你在报怨前已经做了这些,[是吧](#提问前) ?)。
这也意味着很有可能是你弄错了而不是软件本身有问题。
编写软件的人总是非常辛苦地使它尽可能完美。如果你声称找到了臭虫,也就置疑了他们的能力,即使你是对的,也有可能会使其中的部分人感到不快。
@@ -417,10 +419,10 @@ X.org 6.8.1 扭曲鼠标光标MV1005 型号的某显卡芯片组
黑客们认为问题的解决过程应该公开、透明,此过程中如果更有才能的人注意到不完整或者不当之处,最初的回复才能够、也应该被纠正。同时,作为回复者也因为能力和学识被其它同行看到而得到某种回报。
当你要求私下回复时,此过程和回报都被中止。别这样做,让 _回复者_ 来决定是否私下回答──如果他真这么做了,通常是因为他认为问题编写太差或者太肤浅,以至于对其它人毫无意义。
当你要求私下回复时,此过程和回报都被中止。别这样做,让 _回复者_ 来决定是否私下回答 —— 如果他真这么做了,通常是因为他认为问题编写太差或者太肤浅,以至于对其它人毫无意义。
对这条规则存在一条有限的例外,如果你确信提问可能会引来大量雷同的回复时,那么“向我发电邮,我将为论坛归纳这些回复”将是神奇的句子。
试着将邮件列表或新闻组从洪水般雷同的回复中解救出来是非常有礼貌的──但你必须信守诺言。
试着将邮件列表或新闻组从洪水般雷同的回复中解救出来是非常有礼貌的 —— 但你必须信守诺言。
### 提问应明确
@@ -432,7 +434,7 @@ X.org 6.8.1 扭曲鼠标光标MV1005 型号的某显卡芯片组
要想理解专家生活的世界,可以这样设想:那里有丰富的专长资源但稀缺的响应时间。你暗中要求他们奉献的时间越少,你越有可能从这些真正懂行也真正很忙的专家那里得到解答。
所以限定你的问题以使专家回答时需要付出的时间最少──这通常与简化问题还不太一样。
所以限定你的问题以使专家回答时需要付出的时间最少 —— 这通常与简化问题还不太一样。
举个例,“请问可否指点一下哪有好一点的 X 解释?”通常要比“请解释一下 X”明智。如果你的代码不运行了通常请别人看看哪有问题比叫他们帮你改正更明智。
### 关于代码的问题
@@ -460,7 +462,7 @@ X.org 6.8.1 扭曲鼠标光标MV1005 型号的某显卡芯片组
抵制这种诱惑,即在求助消息末尾加上诸如“有人能帮我吗?”或“有没有答案?”之类在语义上毫无意义的东西。
第一,如果问题描述还不完整,这些附加的东西最多也只能是多余的。第二,因为它们是多余的,黑客们会认为这些东西烦人──就很有可能用逻辑上无误但打发人的回复,诸如“是的,你可以得到帮助”和“不,没有给你的帮助”。
第一,如果问题描述还不完整,这些附加的东西最多也只能是多余的。第二,因为它们是多余的,黑客们会认为这些东西烦人 —— 就很有可能用逻辑上无误但打发人的回复,诸如“是的,你可以得到帮助”和“不,没有给你的帮助”。
一般来说,避免提“是或否”类型的问题,除非你想得到 “[是或否”类型的回答](http://homepage.ntlworld.com./jonathan.deboynepollard/FGA/questions-with-yes-or-no-answers.html)。
@@ -495,7 +497,7 @@ X.org 6.8.1 扭曲鼠标光标MV1005 型号的某显卡芯片组
最理想的方式是向最初提问的线索回复此消息,并在主题中包含“已解决”、“已搞定”或其它同等含义的明显标记。
在人来人往的邮件列表里,一个看见线索 “问题 X”和“问题 X-已解决”的潜在回复者就明白不用再浪费时间了(除非他个人觉得“问题 X”有趣因此可以利用此时间去解决其它问题。
追加的消息用不着太长或太复杂,一句简单的“你好──是网线坏了!谢谢大家──比尔”就比什么都没有要强。
追加的消息用不着太长或太复杂,一句简单的“你好 —— 是网线坏了!谢谢大家 —— 比尔”就比什么都没有要强。
事实上,除非解决问题的技术真正高深,一条简短而亲切的总结比长篇大论要好。说明是什么行动解决了问题,用不着重演整个排错的故事。
对于有深度的问题张贴排错历史的摘要是恰当的。描述问题的最终状态说明是什么解决了问题_在此之后_ 才指明可以避免的弯路。
@@ -548,7 +550,7 @@ X.org 6.8.1 扭曲鼠标光标MV1005 型号的某显卡芯片组
## 别象失败者那样反应
在黑客社区的论坛中有那么几次你可能会搞砸──以本文描述或类似的方式。你会被示众是如何搞砸的,也许言语中还会带点颜色。
在黑客社区的论坛中有那么几次你可能会搞砸 —— 以本文描述或类似的方式。你会被示众是如何搞砸的,也许言语中还会带点颜色。
这种事发生以后,你能做的最糟糕的事莫过于哀嚎你的遭遇、宣称被口头攻击、要求道歉、高声尖叫、憋闷气、威胁诉诸法律、向其雇主报怨、忘了关马桶盖等等。相反,你该这样去做:
@@ -569,7 +571,7 @@ X.org 6.8.1 扭曲鼠标光标MV1005 型号的某显卡芯片组
这些找茬者要么是毫无办法但自以为是专家的不中用家伙,要么就是测试你是否真会搞砸的心理专家。其它读者要么不理睬,要么用自己的方式对付他们。这些找茬者在给自己找麻烦,这点你不用操心。
也别让自己卷入口水战,大多数口水战最好不要理睬──当然,是在你核实它们只是口水战、没有指出你搞砸的地方,而且没有巧妙地将问题真正的答案藏于其中之后(这也是可能的)。
也别让自己卷入口水战,大多数口水战最好不要理睬 —— 当然,是在你核实它们只是口水战、没有指出你搞砸的地方,而且没有巧妙地将问题真正的答案藏于其中之后(这也是可能的)。
## 提问禁忌
@@ -590,7 +592,7 @@ X.org 6.8.1 扭曲鼠标光标MV1005 型号的某显卡芯片组
**问:**
我到哪可以找到某程序或 X 资源?
**答:**
在我找到它的同样地方,笨旦──在网页搜索引擎上。上帝啊,难道还有人不知道如何使用 [谷歌 ](http://www.google.com/) 吗?
在我找到它的同样地方,笨旦 —— 在网页搜索引擎上。上帝啊,难道还有人不知道如何使用 [谷歌 ](http://www.google.com/) 吗?
<a id="id265951"></a>
**问:**
@@ -614,7 +616,7 @@ X.org 6.8.1 扭曲鼠标光标MV1005 型号的某显卡芯片组
**问:**
我的{程序、配置、SQL 语句}不运行了
**答:**
这不是一个问题,我也没有兴趣去猜你有什么问题──我有更要紧的事要做。看到这种东西,我的反应一般如下:
这不是一个问题,我也没有兴趣去猜你有什么问题 —— 我有更要紧的事要做。看到这种东西,我的反应一般如下:
* 你还有什么补充吗?
* 噢,太糟了,希望你能搞定。
* 这跟我究竟有什么关系?
@@ -710,9 +712,9 @@ _对初犯者私下回复。_ 对那些坦诚犯错之人没有必要当众羞
_如果你不确定,一定要说出来!_ 一个听起来权威的错误回复比没有还要糟,别因为听起来象个专家好玩就给别人乱指路。要谦虚和诚实,给提问者与同行都树个好榜样。
_如果帮不了忙,别妨碍。_ 不要在具体步骤上开玩笑,那样也许会毁了用户的安装──有些可怜的呆瓜会把它当成真的指令。
_如果帮不了忙,别妨碍。_ 不要在具体步骤上开玩笑,那样也许会毁了用户的安装 —— 有些可怜的呆瓜会把它当成真的指令。
_探索性的反问以引出更多的细节。_ 如果你做得好,提问者可以学到点东西──你也可以。试试将很差的问题转变成好问题,别忘了我们都曾是新手。
_探索性的反问以引出更多的细节。_ 如果你做得好,提问者可以学到点东西 —— 你也可以。试试将很差的问题转变成好问题,别忘了我们都曾是新手。
尽管对那些懒虫报怨一声“读读该死的手册”RTFM是正当的指出文档的位置即使只是建议做个谷歌关键词搜索会更好