20121010-如何有效地技术沟通

如何有效地技术沟通夏华夏〔演讲时隐藏〕结合工作中的几个实例，讨论如何在日常工作进行准确的技术沟通，如何能够将技术有效沉淀和传播不涉及：如何揣摩领导的意见如何委婉提出批评如何在述职时包装自己的工作。。。。百度的文化是简单可依赖从Robin的鸡翅说起沟通漏斗尽量用文字沟通文字可以传承而不损失信息含量文字可以帮助知识的积累“文明”时代是从文字的使用开始会议沟通要有会议纪要

注明时间、人员记录会议结论写明需要跟进的事项私下沟通也在适当范围通报分享百度运维官方群里的一段对话：

某某15:59:05 XXXX又CORE了！！！

某某某15:59:47

私聊

某某15:59:51

嗯需求、bug要用email、spark等沟通

一次对话Q：这个问题为什么这么久了还没有解决？A：跟xxxx团队反映过，他们没有fixQ：怎么反映的？A：跟他们的一个RDxxx同学说过好几次Q：。。。使用文字提需求准确传到达决策人对需求方、开发方都是一种提醒有账可查做系统要有文档

开发前有设计文档开发后有使用文档、运维文档帮助开发、QA、运维团队准确技术沟通帮助后续接手的同学快速学习文档要有时间、地点、人物、链接时间标明了有效性提到其它文档请给出链接反例：“总体架构参见xxxx总体设计文档”，但是一搜，搜出的xxxx总体设计文档有N个版本TODO要有时间、人物写程序要有注释

文件头写明文件功能、时间、作者函数前的注释写明函数功能用法等给文件、类、函数、变量一个准确的名字程序要遵循统一的风格例如：C++编程标准苦逼的程序员要对自己好一些程序员都很苦逼的啊，有木有！读别人程序的程序员更苦逼啊，有木有！！读没有注释、没有文档、变量名很短、每一行很长、自己写的程序竟然读不懂的程序员最最苦逼，有木有！！！尽量用简单、直接、准确的文字沟通“中国好声音”上，大山mm选择导师的时候说：我记得上次指出我错误的选项是哈林老师但是，上次是那英老师鼓励了我但是我是一个爱学习的孩子，所以我选择哈林老师这在娱乐中常用，无可厚非技术文档那么讲究直来直去先摆明观点，再补充内容技术沟通应该直来直去“摆明观点->阐述理由->总结”一篇文章，首段是中心思想一个段落中，首句是中心句一封email，标题是主要内容一个代码CL，logmessage概括主要内容Email也要先讲要点标题：fwd:校招推荐hi张媛，

这个同学的简历很好，比较适合在bfe或者其它研发为主的团队。他因为一直在腾讯实习，错过了哈尔滨的校招。能否帮助安排他的面试？

谢谢，

华夏标题：请安排校招面试-xxxhi张媛，

能否帮助安排这个同学的面试？他因为一直在腾讯实习，错过了哈尔滨的校招。他的简历很好，比较适合在bfe或者其它研发为主的团队。

谢谢，

华夏Hi上聊天要直接某某某15:35:15hi华夏某某某15:35:37你好某某某15:36:03在吗？华夏16:08:48Hi你好，刚刚在开会。有什么事吗？某某某16:59:01想问你个关于实验平台的问题华夏17:36:16是什么问题？某某某17:40:03你什么时间有空？我想当面请教Hi上聊天要直接有效的方式：某某某15:35:15hi华夏，想问你个关于实验平台的问题。。你什么时间有空当面沟通一下？SVN提交时的标题、注释要有意义反例：一个文件的SVN更改记录：(格式为“svn号更改内容”〕xxxxxxbugfixxxxxxxfixabugxxxxxxbugfix.xxxxxxbugfix.xxxxxxfixasmallbugxxxxxxfixtheconfigerror.xxxxxxfixtheconfigagain.尽量用可传播的、可修改的文字沟通可传播的让以后的同学可以看得到你的文字可修改的让文档随着时间的推移不断完善选择适宜的工具技术文档尽量使用wiki可以更新修改wiki>doc>ppt>pdf不管哪种方式，都要公开，而不是在私人email需求尽量使用bugtracking工具spark/jira>email>hi>口尽量开放访问权限

邮件沟通选择适宜的邮件组尽量让所有相关人员参与讨论有价值的东西不要把她藏在私人邮箱使用备份了的邮件组(e.babel.baidu)放到wiki上文档、代码尽量让大家都可以修改反例：icafe设计文档只有rd可以修改？反例：svn代码写权限只对少数人开放？总结尽量用文字沟通尽量用简单、直接、