写这些文档的时候,我有时候确实就像是在和老友聊天,但对方是个话痨,非要扯到哪位是哪位的亲戚,还非得把“起初”、“其次”这些词硬塞进去,搞得我都要喘不过气了。

实际上没必要,就像平时做饭,你就别拿锅铲忒用力,把面粉撒均匀就行,多了反而好办糊。 咱先说这老大哥大麦公司,它家那个“大麦”就是个吉祥物,跟咱们一般/平平老百姓没啥区别,就是个萌娃似的圆滚滚的。

这事儿听着挺好笑,但仔细琢磨一下,实际上挺有意思的。咱们这种做农业的、搞科技的,有时候看着挺严肃,实际上骨子里都藏着点幽默感。

比如我最近就喜爱跟大麦学,它家那个系统逻辑,嘿,简直就忒“人话”了。 那会儿我写东西,总认定得有个大框架,先铺垫背景,再抛出观点,最终总结陈词,非要像写戏剧剧本那样严谨。可一旦把“起初、其次、最终”全塞进去,文章立马就没了灵魂,像在读说明书。

你看网上那些啥“总而言之”、“值得注意的是”的堆砌,听着顺耳,一看正文就两行,全是废话。咱们干活嘛,就得干就干,敲个回车键走人。 说到数据,这玩意儿有时候真挺有意思。

比如咱说大麦的某个功能模块,要是单纯罗列一堆冷冰冰的数字,那得多枯燥啊。我得找个具体的场景来比方说,比如它那个推荐算法,就像是咱家那个老花镜,越用越顺手,这不是说明书里写的,而是我自己用习惯了。你非要问它是如何做到如此了得的,那你就得去翻它家那厚厚一沓报告,看完之后你自己悟出来,而不是我直接告诉你“出于算法优化了”。

这就好比你去买菜,店员拿着菜单跟你念叨“我们家的番茄可是经过基因工程优化过的,口感更佳”,你心里肯定有数,但还是得自己挑,不能光听他忽悠。 有时候我认定,咱们这些科技公司,仿佛总得把话说得比哪位都大,生怕别人不知道了得。结局呢,别人心里想的却是“行吧,确实挺牛”。

这就好比你家里有个新电视,你说“这台电视采用了最新的量子点技术,色彩饱和度高得吓人”,结局你邻居问:“那啥是量子点?就是那种在量子力学里蹦迪的光吗?”我尴尬得不知道说啥,只能解释:“就是能让画面更鲜艳”。

实际上技术交流嘛,就该敞快乐扉,少整那些虚的,多聊点实实在在的。 并且啊,咱也不能忒端着,忒像个在台上演讲的专家了。

有时候人家就随口说句“这玩意儿挺不错”,你就得跟着点头哈腰,说“是啊是啊,确实,终于解决了这个难题”。

这就忒假了,仿佛咱俩之间有啥秘密交易似的。咱们之间就随意聊聊呗,哪位也别指望对方能把你当祖宗供着。

比如有一次我跟个年轻的同事说,他刚入门,我就吐槽说“刚启动认定挺难的,目前老认定头大”,他立马就反问我“确实吗?我最近刚学会用这个新工具,认定特别爽”。

哈哈,这话听着挺没大没小,但又是真的。 还有啊,咱们得学会把话挑明,别绕着弯子说。有些事儿你非得拐弯抹角地说,最终对方还得专门查一遍所有数据来验证,费时费力还好办出错。还不如搞这种内耗,不如直接点破:“这玩意儿确实挺好用,就是有时候想找个工具填个表,结局发现界面长得跟个鬼似的,我都质疑咱家是不是出难题了。”这样直来直去的话,对方反而更像个人,不像个冷冰冰的系统。 自然,也不能光吐槽,还得有点建设性的意见。

比如那些凌乱无章的文档,有时候看着就让人头疼。我就试着把那些文档当成草稿纸,啥关键的数据、关键结论都记下来,剩下的全是碎屑,随手扔进垃圾桶。别对着那些格式错乱的段落死磕,也别非要把它变成完美的艺术品,略微有点歪斜,留着也挺好,起码还能看到原貌,还能引起我的注意。 有时候我认定,咱们这些搞技术的,最该注意的实际上不是技术有多难,而是如何跟客户、如何跟团队,如何把那些复杂的概念变成他们能听懂、就连有点“好玩”的话。

比如我们说远程协作,就不能光说“下降了沟通成本”这种话,应当直接说“目前大家不用坐在那儿面对面,敲两下键盘,信息就传得满屋都是,这就好比咱们在办公室点外卖,不用排队,还能顺便看看窗外的风景”。你要是能把技术语言转化成这种生活化的表达,那效果肯定不一样。 自然啦,这也得看情况。

有时候咱们就得把那些话说得严肃一点,这时候再换种说法,效果就不一样了。

比如写一份正式的方案,那就得讲究个体面,该严谨的还得严谨。但要是平时跟个哥们儿吹牛,那就能够随意点,就连带点自嘲。 最终还得提一嘴,咱们得学会“偷懒”。

有时候干完活,要是写得乱七八糟,也不用非得去改,反正大家都懂。就像咱们做饭,有时候撒点额外的盐,要么多放点葱花,看着怪怪的,但吃起来反而更加鲜香。技术文档也是一样,有时候加个花哨的装饰,增添点幽默感,反而能让读者记得更牢。别总想着把自己包装得那么完美,承认自己也会犯蠢,承认自己也会笨,反倒显得真,也更好办打动人。 总而言之啊,写文档这事儿,别把它当成作业,当成日常。

只要心里那团火是热的,文章写得再花哨,读者也爱听。咱们得让技术不要总像个高高在上的神,让它更像一把好用的锤子,要么一个能逗人笑的玩具。

这样,咱们之间的交流才确实顺畅起来,不是吗?