话题:程序员酒后吐真言,竟然这样说 | 技术写作什么鬼

据说,美国最大的论坛 Reddit,最近有一个热帖。一个程序员说自己喝醉了,做了10年软件工程师,心里有好多话想说,"我可能会后悔今天说了这些话。"

他洋洋洒洒写了一大堆,获得9700多个赞。

其中有一条竟然是说:

作为一名工程师,最被低估的技能是记录。说真的,如果有人可以教我怎么写文档,我会付钱,也许是1000美元。

原文:https://old.reddit.com/r/ExperiencedDevs/comments/nmodyl/drunk_post_things_ive_learned_as_a_sr_engineer/

我天。好想采访这位程序员,好奇想知道:

  • 他为什么会产生这样的想法,是有哪些痛苦的经历吗?以及,

  • 如果他真的愿意支付1000美元学习技术写作,希望了解哪些知识,最终达到怎样的水平呢?

可惜,我不会翻墙,访问不了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

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值