提示11-13

今天继续学习本书的提示11-13。还是先看提示：

提示十一：英语就是另一门编程语言
提示十二：说什么和怎么说同样重要
提示十三：把文档嵌进去，而不要栓在表面

今天的内容主要都在说交流。作者认为我们作为开发人员不仅要学会写代码，更要会交流。他总结了交流过程中的几个要点：了解听众、明白自己想说什么、选择时机、挑选风格、让它听起来不错、让听众参加、做倾听者、回应别人。总结完说话的技巧之后他又提出了说话的内容同样重要，我们需要注意输出内容的有效性。最后，作者提到了一项同样重要但是却经常被开发人员忽视的问题：文档。他提出了自己的想法：直接把文档写在代码里。但是注释源码也不是一味蛮干、而是要有选择地记录独特的项目细节。

交流一直是人类生存最重要的技能。我也经常明明好像在脑子里面都想好了，说出来就词不达意，结合今天看到作者总结的技巧深有启发。我的经验是面对重要的内容时，一定要提前写下来，脑子里面想的东西一点都不靠谱，每次写下来的时候才知道记忆里面的很多东西都错漏连篇。至于说话的内容，那肯定是交流的核心，不过这个可能就靠提前准备或者日常积累，我也没有想到什么特别好的方法。最后把文档和代码结合，我目前认为最后的文档就是代码本身，只有少部分由于各种原因特殊做的或者有什么代码难以描述的取舍，那就用注释写上。不过这一切的难题就涉及到了代码结构的划分和代码的命名。想到经常纠结于一个方法或变量的命名。这里又想到了最近发现的一个代码命名神器——CODEIF。它通过搜索项目源码，可以找出已有关键字的变量名，甚至还能直接展示相关源代码，有机会可以用起来。

终于看完了第一章：务实的哲学。总结一下，这一章主要是讲一些大道理的。但是作者并没有讲得很空泛，反而有很多地方都让我深有体会。这一部分放在第一章应该是想告诉我们，对比接下去的那些细节的编码技巧，这些大道理要有用的多。只有有了正确的态度和方法，才能驾驭那些琐碎的细节。生活中其他事情也都是同样的道理，代码亦是人生。接下来就让我端正态度，在新的一周开始学习作者具体的编码技巧吧。