寫在前面：
下面這封東西的原Title是如何寫好FR郵件。FR是我公司內部的術語，不多做解釋，該看懂的結合語境很容易懂。
我不完全贊同這封東西的內容。
但這封東西的筆法和情感立場，才是真正的程序員裝逼指南。程序員真正的逼格在心裡，只有通過代碼和文字，才能裝出來。
______________________________________________________________
筒子们，
这封邮件我试图分享一下我个人关于如何写好FR分析邮件的一些看法，供大家参考。
如果哪位同学有更好的心得，欢迎一起拿来晒晒，大家一起学习。
1） 我们为什么要写邮件？
我们写邮件是为了向读者展示我们的分析结果，并说服读者认同并接受我们的观点。 通常那是我们的劳动成果，不应当被误解或抹杀。
2） 好邮件得标准是什么？
读者通过阅读我们的邮件，理解并接受了我们的观点。因此，好邮件的标准只有一个：是否被读者理解并接受。
3） 我为啥要写“好”邮件？
原因有二：
3.1) 为了更好地呈现我们地专业水平。咱们费了老大力气，从数万行trace/log中分析整理出一个结论，容易吗？干嘛不拿出来秀秀？
3.2) 就算咱不图3.1),这样做也能减少我们自己的麻烦。 读者没有理解并接受你的观点，必然不会放过问翻你的机会。他们也需要这样的机会秀出自己的专业素养，并且他们会很乐意提出各种问题，毕竟提问总是比回答要来得容易:-）
4） 怎样才能写出“好”的邮件？
我们唯一的目标是写出读者能够理解并接受的东西。因此首先就要看清楚谁是我们的读者。
读我们邮件的人，通常有： Manager, Leader, Spec, L3 interface, tester, developer. 这些人可以被分做两类：
4.1) 剑（贱）客: 包括所有的developer,tester;//很不幸，俺们也是其中一员。
此类读者的特点是：
4.1.1) BT. 对于他们来说，太短的trace，读来根本不过瘾。
4.1.2) 剑术高人（ ＝> 贱人？）。太详细地注释trace，会让他们觉得你在轻视他的专业水准。
4.1.3)通常他们的问题都很致命。并且他们时刻准备砍翻你。
4.1.4)通常他们闭嘴之后，其他人从才可能闭嘴。
4.2)根据剑客们的特点，作为一个专业写手，咱们的对策必然是：
4.2.1) 严防死守。邮件中可以没有信息(就像某董事长的访谈一样，喷了一下午，信息含量约等于0），但是绝不能有错误虚假信息。否则必死。最后灰头土脸地牺牲个人技术信誉，白白增长了对方的功力。
4.2.2) 他们不应当成为我们邮件的主要攻关对象。 =>剑客满意 不等于 猪们满意。
只有猪们才能决定这个问题会不会兜一圈后再次回到你手上白白消耗你的生命力，因此，让猪们满意，才更符合ALU的社会宪章：客户至上。
只有真正的客户才至上。剑客们显然不是。
4.3) 猪：包括所有的Manager, Leader, Spec, L3 interface ….。
此类读者的特点是：
4.3.1) 通常他们没有耐心/能力读懂长篇引用的trace/log（主要是后者，也因此变得更没有耐心）;然而过于通俗的解释，也容易被误解为对其剑术修为的低估。
4.3.2) 通常 IQ介于0到75之间，只能接受逻辑正确的结论，再多的技术细节技术难点也吓不倒他们（无知者无畏）。所以任何愚蠢的问题都可能问得出来。为了避免回答愚蠢得问题，咱们必须用尽可能通俗的语言分析trace，和表达观点。
4.3.3) 通常他们都曾经是优秀的剑客。除了“以理服人”之外，再没有其他的办法能让他们接受你的观点。
4.3.4) 通常他们英文都不错。＝>Chinglish可能招来大麻烦。
4.3.5) 最后也是最重要的，通常他们都拥有决定FR走向的权力。
4.4) 根据猪们的特点，作为咱们重点攻关的对象，咱们的对策必然是：
4.4.1) 严格采用八股文格式：（比如我这封邮件，就用了毛主席推荐的开中药铺大法）
4.4.1.1) 邮件开头部分，稍微吹嘘一下自己的苦劳之后，就旗帜鲜明地摆出自己的观点。总论部分不宜太长，也不必展开，无须引用trace来支持。
比如下文我发给CHEN LILI的邮件：
Your understanding to issue 2) is not correct.
Maybe XU SHILING didn’t organize his mail correctly. I try to clarify the facts I saw here.
Lines with prefix // are my comments.
4.4.1.2) 接下来就是分论部分。不妨引经据典，不厌其烦地解释分析trace/log/文档。有两个原则我们应当注意：
4.4.1.2.0) 最重要的是，写出来的东西，要确保猪都看得懂。咱们自己看懂了不够，剑客们看懂了也不够，一定要保证猪们都看得懂！
4.4.1.2.1) 每一段话依然要保持总－分－总的三段式八股结构。一句话表明观点，引用1～2行关键trace来支持该观点；再用一句话小结。
4.4.1.2.2) 一段话只表达一个观点。如果有多个观点，各分一段。配合邮件版式。缩进，字体，颜色等都可以用上。
4.4.1.2.3) 不厌其烦，罗嗦一点也无妨。猪们对于他们能够看得懂得东西一般不会唧唧歪歪，相反，出于恐惧，对于他们不懂的东西会狂问问题，
4.4.1.2.4)稍微引用一下某些缩略语，辅以简单的说明，可以增加猪们的专业自豪感。比如下文中的ACTIVE_HEALTH/EXTRACTION_PENDING：
//CCP2 1.3.10’s handler was OPEN [ hotswap state trans from 2 ( ACTIVE_HEALTH) => 4 ( EXTRACTION_PENDING)] at Nov 29 08:37:35:190;then closed [ 4 => 2 ] at Nov 29 08:37:35:330
总是用大白话表述问题，猪们并不一定会领情，因为你丫摆明了在蔑视他的剑术修为，须知：每一头猪，过去都是一名优秀的剑客。
4.4.1.3) 最后就是总结部分。我方辩友再次亮出自己的观点，顺理成章地将AP交给其他模块去接着研究。。。。
4.4.2) 可以罗嗦，但是别讲废话。实在没话可讲又不能不讲，那就至少要做到:只讲废话，不讲错话。对于自己没把握的东西，谦虚地说明，I’m not sure, it’s not clear yet….实在要犯错误，就用电话，别写邮件。;-0
4.5) 其他注意事项：
4.5.0) 在邮件的开头清楚地总结自己的观点。方便没时间/耐心的猪们看一眼邮件摘要就知道是否必要看完邮件。。。。
4.5.1) 关键的解释，一个字都不能省。
4.5.2)简洁地引用有说服力的关键证据，比如trace,log或者文档；避免整段整段地贴trace，这次你虽然省事了，下次他们的问题只会更多。。。。
4.5.3) 配合详尽的注释。罗嗦不是罪过。别担心公司会因为你多写了几行邮件就发不出工资，BID有充足的预算购买邮件服务器和添加硬盘。
4.5.4)心中有猪，手中无猪。我们写每一个字的时候，要时刻记得反省：猪们的IQ能否理解这么复杂的逻辑？如果不能确信，就分解成几步，不厌其烦地说明；
当然太多的细节和trace,除了会引起剑客们的攻击之外，猪们也会因为你对他们IQ的低估而愤怒。而最终，猪们的愤怒会转化成作者的workload…:-)
4.5.5) 心里传球，手上带球。谁都不想要AP。问题的关键是，我们必须按照游戏规则把球传给下家。直接说：It’s not MXPF/PMS/SWM/HWM的问题。。。
只会让人怀疑你的敬业精神。但是换种方式表达，就好很多了： If FM send PMS the expected message, we will act as what we designed…
4.5.6)用语要低调，别怀疑任何人的专业能力和专业精神。如果你喜欢把事情搞搞大，当然可以破口大骂，前提是你做好了准备为此付出代价。。。。
今天就喷到这里了。欢迎拍砖。
//特别鸣谢：
感谢XU SHILIANG同学贡献了这个反面典型案例给大家解剖。希望XU SHILIANG 同学不要介意。:0(
wuzq
Leave a Reply
You must be logged in to post a comment.