据说,美国最大的论坛 Reddit,最近有一个热帖。一个程序员说自己喝醉了,做了10年软件工程师,心里有好多话想说,"我可能会后悔今天说了这些话。"
他洋洋洒洒写了一大堆,获得9700多个赞。
其中有一条竟然是说:
作为一名工程师,最被低估的技能是记录。说真的,如果有人可以教我怎么写文档,我会付钱,也许是1000美元。
原文:https://old.reddit.com/r/ExperiencedDevs/comments/nmodyl/drunk_post_things_ive_learned_as_a_sr_engineer/
我天。好想采访这位程序员,好奇想知道:
可惜,我不会翻墙,访问不了reddit……有没有人可以指导一下?
又一次,想起百度的章淼老师。他也曾就程序员的写作能力,表达观点:
如果从代码的质量考察,我估计中国互联网圈合格的程序员不会超过20%;如果从项目文档的角度考察,中国互联网圈合格的程序员大概不会超过10%。和代码比起来,项目文档是一个更加严重的问题——几乎所有人都会认为代码是一个软件项目的产出;而只有很少的人会同意,文档也是一个软件项目的重要(甚至是不可或缺的)产出。
记得和某外国公司同行(也是中国人)聊起这个话题。
“你们需要写设计文档吗?”
“当然了,而且设计文档一定会经过严格的review。”
“那你在这里一定会感觉震惊的,很多即使是基础架构的系统都没有严格的设计文档”。
当我告诉对方这个情况的时候,我也很清楚,这绝不是一家公司的个案,而是一个普遍的情况。
公众号:章老师说怎么写项目文档
章淼老师是清华大学的博士,毕业后留校任教。教书多年,觉得象牙塔不接地气,想去企业历练几年,再回学校教书。于是,他跑到百度主持了BFE项目,然后就再没离开。回不去讲台的章老师依然好为人师,于是他在百度大学,面向研发工程师,开设基本研发能力教育的课程,《怎么写项目文档》就是其中之一。
无独有偶。清华大学也推出写作与沟通课程,旨在提升理工科专业背景的学生的写作与沟通能力。正如清华大学在官网的课程介绍中写的那样:
正如清华大学副校长彭刚所言:写作课是一门“让学生开眼的通识课”。2018年起,清华面向大一新生开设写作课。至今,写作课组建了由专职教师25人、和来自8个不同院系17位校内教师构成的豪华团队,招聘专职老师要从1000多位高水平申请人优中选优,前前后后经历6轮教学能力和写作能力的考核。2021年春季学期,写作中心25名专职教师和8名院系教师开设了43个不同主题的108个小班课堂,预计首次实现大一新生“全覆盖”目标。
“写作与沟通”课程:春风化雨 立德树人@清华大学
没想到,这门劳什子的课程,竟然受到了学生们的欢迎,并且给出了很高的评价:
2020年秋季,清华大学34位教师开设了109个课堂的“写作与沟通”课。日前,学校分别公布了清华大学2020年秋季本科教学评估结果和通识课程第三方质量评估结果。写作课全部34位授课教师中,有8位名列全校本科同类课程教学评估前5%。在通识课程第三方质量评估中,全部写作课均被评价为“教学高能课”,还有一部分课程被评价为“教学高能+学生高投入课”。
清华大学“写作与沟通”课为何屡获好评?
看来,技术传播不仅仅在专业领域飞速发展,更加成为技术领域从业人员的通识能力。
不知道你是否也曾遭遇职业痛点,并因此意识到写作的重要性,期望有机会提升技术写作能力——找我聊聊呗?
其他推荐:
实施:GitHub + MarkDown 文档系统的工作环境部署及工作流程说明 | 技术传播
技术传播是一片蓝海 | 技术传播
访谈:TC无处不在,只是我们没有发觉 | 技术传播
这次他们说好要“讲真的” | 传播
在座都别吵了,你们还有我 | 技术传播
一本培养强迫症患者的说明书 | 技术传播
就像用心做好日本料理 | 技术传播
顽固的老头子与无聊的说明书 | 技术传播
转战新媒体 | 技术传播
评测:王者荣耀的用户帮助系统 | 技术传播
让爸爸妈妈也能享受到科技发展带来的便利 | 技术传播
企业级信息管理系统初创方案构思 | 技术传播
睿齐
技术传播从业者
品牌内容策划
自由摄影师
自由撰稿人
汪力迪
公众号:techcomm / htstory
微信号:bgrichi
邮箱:hash_0813@163.com