00:00
各位现场的同学,然后大家好,还有那个在网上的同学,就是大家下午好,也非常开心,嗯,大家能够花这么下午这么宝贵的时间,还是工作日啊,来学习我们这个技术的写作,那其实我觉得腾讯云去举办这样一个活动是非常有意义的,因为其实在我看来的话,技术的创作是对于我们技术人来说非常有意义的一件事情。可能很多同学都没有意识到他的意义啊,那其实呢,呃,我这边浅谈一下我的感受吧,就是说呃,在技术创作到底对于我们这些人有什么意义呢?首先的话。嗯,之前在我们内部有一门课程啊,就是那个得到的CEO托布花,他曾经在我们内内部开开过一门课程,这个课程讲的主要是职场的软技能方面的,那么他就说过一个很重要的观点啊,就是说我们希望呢,我们这些所有的职场人呢,不光是技术人,他们都希望能用自己的软技能去为自己的硬实力啊。加一个杠杆,那这个杠杆什么意思呢?就是说希望我们能够让我们的呃,我们自己的实力能够得到一个放大的作用,那其实呢,他在他的眼里来说的话,这个写作和演讲就是我们的软技能中最重要的两项加分项了。
01:15
那因为这两个,呃,这两项技能呢,会为我们带来很多很多的作用,其实它最重要的作用是可以让我们的影响力啊,突破我们所在的圈层。这个是什么意思呢?圈层不代表阶层啊,就举一个很简单的例子,就是说比如说我作为一个技术人,在内网写一些文章。可能这个文章啊,包括腾讯知识讲的一些获奖的文章,那可能就会被我们公司的,呃,包括CEO啊,马化腾啊,他们能看到这个东西,但是如果我以我以以往所做的一些工作的话,那可能接触到这个圈层的话,实际上是比较难的,但是通过写作这个方式,我就可以让我的影响力突破我所在的圈层,所以呢,大家都明白说用我们通过我们这个软实力呢,能够实现我们硬实力的一个放大作用,能够能为我们的硬实力加杠杆。
02:02
所以呢,就可以让我们的影响力突破我们的圈层。那第二个点呢,刚刚。其实张老师和杨老师他们都说了一个很重要的观点,张老师他是做公众号的,然后杨老师呢,他也是出书的,那其实呢。大家可以可以看到这这上面有一个什么样的共同点,就是这两个东西其实都能够赚钱,对不对,所以呢,当时我这里想谈的不是赚钱的问题,就是说其实呢,他的核心思维是在于写作这件事情能够让我们的。行为呢,产生复利啊。什么叫复利呢?就是说其实我们同样的内容啊。可能比如说你做一个,嗯,产品的需求,或者实现一个技术的功能的话,那做完之后就做完了,它的价值在你做完的那一刻就已经交付了,并且兑现了。但是写作不一样,写作呢,我们写一次,我们可以发表在不同的平台,包括我写的文章,很多是开始在发,发表在内网,那后面呢被转载到外网,然后呢,因为写的好呢,可能会被邀请去做一些,呃。嗯,内部的一些直播的分享,然后呢,可能会去做一些外部的直播的分享。
03:04
那最后呢,可能写的好的一些部分呢,未来也可能会成为呃,一些培训呢,或者是说书籍的一些题材,所以呢,你写一篇文章呢,会持续的在产生作用,那这种东西呢,就叫做复利,所以呢,如果我们技术人都能够意识到,其实写作这个东西跟我们做需求和学技术是不一样的,它能产生复利。能产生复利的东西,对我们才是真正有价值的东西。所以呢,因为大家也意识到现在这个,像现在这这种对于我们程序员来说很重要的很现实的一个问题,就是所谓降本增效的一个问题嘛,那各个大厂都在裁员,那么什么样的价值是我们可以终身受用的呢?那我觉得写作的这个价值呢,是一个很很重要的一个可以终身受用价值,因为它是会产生复利的。然后最后还有一个点呢,就是说我认为写作这个能力啊,是我们程序员一个很重要的一个差异化竞争的一个手段。这也是我最近我的领导找我谈话的一个一个一个见解,他觉得诶,比如说我们很多程序员,他技术其实非常好啊,或者是说他其实行为上也很靠谱,但是他可能不会写,也不会说,那么如果你有这个能力呢,你其实就产生了一个很好的差异化竞争的能力,就会让很多很多以前没有关注你的人去开始关注你,其实大家都知道,在职场中如果能够被领导或者说一些重要的人关注,这个是你获得好绩效,或者说获得好资源的一个开始,所以呢,我觉得写作呢,是一个我们很重要的一个职场人的一个。
04:33
差异化竞争的手段。那最后呢,其实对于我们,呃,对于我来说的话啊,作为一个知识分子来说的话,其实写作更代表着一种很远大的追求,因为中国的知识分子其实一直都追求所谓立德立功立言嘛,那这个写作其实就是立言的过程,你能不能够在说我我我做了一些东西,能够对这个社会产生一些影响,能够记录下来,甚至说后世的人都会去去看你的东西,这个其实是一个很重要很重要的一个对于我们这识分子的一个追求吧,这是我个人的一些体验啊,但是这个是开开场白,还不是我们正式要讲的内容,那其实我这次要讲的内容呢,其实是跟刚刚才两位老师不一样的点,是说为我是作为一个在职的人员。
05:17
而且是嗯。而且是一个。腾讯的在职人员,我来分享一下我们这个创作对于我们这样在职的人员到底有哪些价值,以及这个我在我在我在这样一个身份之下,我是怎么做技术创作的,嗯。是这样一个情况。那首先我简单做做一个自我介绍。嗯,我叫刘若愚,然后是来自腾讯的微信支付线啊对,刚好今天也是微信支付的十周年啊,这也是非常巧的一件事情,然后呢,我呢是经常在内内部做一些知识分享,刚刚也说过,就是获过四次那个腾讯知识奖,并且呢也呃多次获得腾讯内网的KM的年度优秀作者,并且呢曾经也获得过包括微信G啊,还有其他的一些BG的一些奖项。
06:08
同时呢,我也自己去做了一个课程,就是关于这个写作培训的这块的,在内网是第一门开开这门课程的老师,对是这样这样一个情况,所以的话,嗯。嗯,大会就邀请我来做一个主讲嘉宾,那接下来我们看看我们这次主要是作为一个在职的分享者,主要是从哪些方面来呈现我的内容啊,第一个内容就是发现。也就是说技术写作对于我们这些在职的开发者,他有什么样的价值,当然这个价值可能跟刚刚张老师和杨老师讲的呢,可能有一些区别,但是也有一些相同之处。第二个点就是探索,我们看看一篇优秀的技术文章,尤其是一篇优秀的技术在职人员写的那样技术文章,他应该具有哪些的必备的要素,然后第三个点呢,就是最重头的地方呢,就是说我们看看我们的高效的。技术写作有没有一些固定的流程,我们按照这个流程就可以写好一篇技术文章呢?那主要是这样一个。
07:04
呃,这三个部分,那我们首先来看。第一个部分啊。就是我们看看技术写作对于我们在职在职的开发者有哪些价值。那其实我这边尝试总结了一下,主要是认为有这四种价值啊,第一种的话就是说。那其实我们写一个文章,其实它最重要的价值肯定是说分享和传播知识嘛。因为如果说大家都愿意分享知识呢,其实呢,他相当于就说我们每个人都在,我们为我们的公司的知识库建设去助力了,那人整个团队和这个公司啊,就会形成这样一种技术沉淀的一一一样一种很好的氛围,其实这是一种无形的资产,因为我们每个在职者如果都去为这个知识知识库。助力的话,那么未来如果我们想获取一些知识的话,其实也会变得更加容易,其实呢,这个会很好,会很好的助力我们每一个人,所以的话,其实我认为第一个重要的作用就是分享和传播知识,并且呢,其实还有一个很很重要的点,就是说其实写文章呢,体现出来是我们的一个技术的表达力。
08:05
那技术表达力其实是提升组织效能,降低沟通成本的一种软技能啊,比如说我平时设计了一个很很牛逼的一个技术方案,但是如果我不能够很好的传递给其他人呢,或者说别人理解不了,那本质上我的技术表达力就不够,那这样子呢,就会导致呢,很多人会来去找我进行一个沟通,就会让我的时间成本上升,或者说我如果负责一个模块啊。我没有写写一个很好的文档,那么每天也会有很多人来来咨询我,那会导致我每天忙的要死,其实就是因为我呢,没有将我需别人需要的知识进行内容文档化,这就会造成了大家的沟通成本变高。所以的话,其实我这边认为呢,第一个点呢,就是说我们。作为我们一个在职的开发者,我们分享和传播知识其实是很重要的,对于组织来说,对个人来说都是很有价值。那第二个点呢,就是说我们呢,通通过这样一种写写作的过程呢,同时还可以去学习和掌握知识,这个点是怎么说呢?其实因为有一个很著名的那个,呃,就是论题啊,就叫做费曼学习法,其实他说的核心思想就是说,如果你想学习和掌握知识的话,最好的方法就是去去把它教给一个没有相关背景的人。
09:14
那最好呢,就是说找一个八岁的孩子,那这样的情况呢,如果他能听懂,那么呢,就证明你真的学会了,所以呢。其实如果从这个角度来看的话,其实我们每个人在写文章的过程中,其实也在不停的去对我们自己进行审问,我们到底有没有真正的掌握这个知识,最后如果我们能够很好的把它表达出来,其实我们自己对这个知识的掌握呢,是非常非常深的了。所以呢,我们我们可以看出,我们写文章的过程,其实就是一种以写代想,以想促讲,以讲验真的过程。那这个这样一个循环呢,就就可以帮助我们很好的去学习掌握知识,那第三个点呢,其实就是说很现实的一个问题,就是说我们可以去沉淀的,沉淀这个总结项目的经验啊。怎么说呢,因为其实呢,我们每个人呢,都会去做项目,但是其实真正的去沉淀这个项目经验的人是非常少的,那在沉淀这个项目经验的过程中呢,其实呢,就是我们不断的去思辨的过程,那这个思辨的过程呢,其实真正的其实在我们的那个开发团队里面,其实真正具有思辨能力的人,通常都是会成为技术大牛,所以的话。
10:20
在写作的过程中,我们锻炼了很好的锻炼了我们这样的一种思辨能力,并且呢,不断的去对我们的项目呢进行复盘,那这样的情况呢,肯定会成为我们技术能力的一个助推器的。那还有一个一个很实用的作用啊,就是说其实每个开发人员其实都会遇到一个问题,就是进行答辩嘛,其实你在写文章的过程中,其实就相当于去变相的去准备了,进行答辩,提前的准备进行答辩,怎么说呢?因为其实首先呢,你会把你的整个这个项目的过程进行一个一个梳理,梳理之后呢,你要通过一些结构化的表达去把它进行表达出来,它中间适用的很多方法,包括金字塔原理啊。或者黄金圈法则,这些原理都是可以适用的,那同时呢,你写出来之后呢,你是不是会发到内网上面,那那公司的这些专家和这些技术达人是不是会对你的这个方案进行一些挑战啊,或者质询呢?那其实这个过程跟你的晋级答辩其实是非常非常类似的,所以呢,你相当于提前呢去进行了一次晋级答辩。
11:17
这些问题呢,可能就提前暴露出来了,那如果你写的很好呢,最后呢,又相当于为自己赚取了影响力,可以说是。有百利而无一害的一件事情,那最后一个点呢,就可以提升个人和团队的技术影响力,这个就不用说了,我们每个人写这个文章呢,其实都是带有一点点私心的,就是希望这个东西呢,能够帮助我们和团队啊,去提高我们的技术影响力,那其实提高技术影响力。不是一句空话,其实对于我们每一个业务,或者说每一个在职的人都是有很大好处的,比如说我就曾经发表很多文章,然后最在最后会附一个我们团队的一个招聘链接,后来发现还真的不少的同学会去来找到我说诶,你们团队需不需要人呢?所以呢,其实这种技术影响力是很实在的一个东西,那最后通过这种这种东西呢,也会很好的去反哺我们业务发展,因为我们这个技术影响力,不管是个人的还是团队的,其实可以很好的去降低我们跟其他团队的一些沟通成本呢。
12:14
所以最后一定会反哺我们的业务发展,这是我对于这个,呃,他技术写作对于我们这些在职人的价值的一个一个看法啊。那第二个点就是说,我们去探索一篇优秀的技术文章的必备要素。那我认为什么样的文章呢,是一个好的文章呢,其实这个其实好的标准呢,本身是很主观的,所以好的技术文章是什么样的呢?这个可能是1000个读者就有1000个哈姆雷特,但是呢,我认为好的技术文章呢,他一般是有几个公认的特点。那有哪几个呢?首先它的基本前提就是内容不能有错误的,你不能够写一些东写一篇文章,最后其中有一些基本的概念的错误,或者是一些呃,方向性的错误,这样子的话会对读者产生误解,那这样的文章其实写的还不如不写,所以呢,好的技术文章,它的最基本的前提是内容没有错误的信息,那除此之外呢,它一般都有以下几个特点。
13:12
第一个特点呢,就是干货满满,也就是说我们的内容啊要丰富,干货比较多。你不能说你写个东西,然后最后非常空洞,大部分都是你自己的一些,呃,一些主观的东西,没有,其实没有什么干货,那这样的文章,其实我觉得肯定不能算一个好的文章,那第二个内容,第二个特点就是说它是非常深入浅出的,也就是说我们写个技术文章啊。他要通俗易懂,能够帮助帮助大家理解。这是一个很重要的一个特点,第三个特点就是专业前沿,也就是说我们的技术,我们技术的这个话题啊,尽量的去比较前沿,像现在流行的TGPT啊,或者一些是一些,呃。呃,AI的那些,呃,画画之类的这些像这种非常前沿的东西,其实是我认为是一个非常好的一个话题,所以的话,其实我们呢,尽量要去写一些比较专业前沿的东西,或者说一些呃,比较具有技术价值的一些东西,那这样的东西呢,我们认为它也是一个好的一个特点。
14:06
那最后一个点呢,我们写一个文章呢,尽量让他受众面比较广。这个受众面比较广的,其实意思就是说呢,我写个文章呢,尽量不只是那些资深的那些。读者能读懂,那其实能不能让一些小白能读懂的,甚至能让一些没有技术背景的人,他也能成为我们潜在的读者,所以呢,受众面广呢,也是我认为一个好的文章的一个很重要的标准。好的文章应该是具有普适性的,当然了,他其中可能有一部分内容,它是有一定的门槛,但是呢,我们要尽量的让他的普适性变得更更广一点,对,这是我的一个特点,这是我的一个呃,自己的一个思考所得,就是说我认为优秀的技术文章。一般应该要具有这四个特点啊。那接下来就讲一下我认为。嗯。对,总结了一下,就是说内容要丰富吸引人,干货比较多,受众面比较广,内容呢也深动有趣,深入浅出,同时呢也专业前沿,好,那接下来我们看第三个部分,也就是这个最重要的部分,就是高效协作的一个全流程。
15:07
那这个地方的话,我们呢,会我自己呢,尝试呢,就是列了一个这样一个流程图,其实也不能算流程图啊,就是一个为了便于记忆,我就把它归纳为了八个方法,所以呢,就类似于六脉神剑或者降龙十八掌,其实就方便大家记忆,都是三个字嘛,那其实呢。他呢,就可以看作我们这个写文章的一个全流程了。那我们要做的第一件事情呢?写文章第一件事情就是要具有同理心,也就是确定我们的目标读者是谁,如果我们不能确定我们的目标读者呢?那那我们后面写的东西一定是会达不到那种呃,预期的效果的。那第二个点呢,就是当我们确定了我们的目标读者之后,我们应该要攒素材,也就是积累文章的素材。第第三步呢,就是说我们当我们文章的素材已经积累的差不多了之后呢,我们就要去定好题,也就是怎么样去确定文章的主题以及标题。
16:01
确定文章的主题和标题之后呢,我们应该是搭骨架,这个情况下我们不要去着急动笔去写,我们应该先去搭骨架,确定文章的这个整体的结构是怎么样的。那搭好骨架之后呢,我们在写的过程中呢,很重要的一个点就是去绘制文章的插图,也就是画好图,这个点呢,也是非常非常重要的,因为好的插图可以帮助我们提升我们这个文章的这个易读性啊是不是?那还有一个很很很重要一点,就是我们写的文章的过程中呢,一定要有干货,怎么样去提升我们文章的内容,其实这个也是重中之重啊,那写写到最后,我们这个文章内容已经基本上写的差不多了,那我们还有一个一个很重要的步骤啊,就是勤润色,怎么样去反复的润色我们的文章。那最后还有一点就是说,当我们写完文章之后,其实我们还要注重平时呢多去阅读,只有通过这种广泛的阅读呢,我们才能吸取到别人写的这种好的一些经验,同时呢去吸取到别人的思路,这样子我们以后才能写的更好,同时呢,这也是我们一个复盘的过程,我们从别人的好的文章中吸取到,诶怎么样,我这个以前的文章能够怎么样去改善,其实这个点也是非常非常重要的,那这个点呢,我就把它命名成练内功,对,那那这边有一有一篇推推荐的文,阅读的文章是发表在腾讯技术公众号上面的,这个文章是如何写好一篇技术文章,看这篇就够了。
17:18
大家有有兴趣的也可以去下来再读一下。那我把这几个流程呢,分成事前、事中和事后三个步骤,那事前的步骤就可以看成我们真正动笔写它的前奏部分,就是我们去确定展素材,还有确定文章的主题啊,以及说确定文章的结构,这些都可以事成事前的部分,因为我们还没有正式动笔去写嘛,那事中的部分就是我们真正去写的过程中遇到的一些问题应该怎么解决,那最后事后的部分可以看成是我们在写完这篇文章之后应该要做的事情。那通过这三三个流程呢,我们就可以把我们整个这个文章创作的这个这样一个流程给串起来了。那我们就一个一个的来看吧。
18:00
第一个点呢,就是同理心。嗯,同理心这个点其实就是,其实刚刚两位老师其实都说过,就是我们要站在读者的角度去思考,那其实这里有一个很著名的一个。一个理论就叫做知识的诅咒,诅诅,诅咒啊,知识的诅咒,不知道大家有没有听过这个理论。其实这个理论呢,它的它的原理非常简单的,就是说一旦你知道了某个知识。你就像被他诅咒了一样,你没办法。站在不知道这个知识的那种人的角度去思考问题,所以呢,我们很多很多同学在写文章的时候,面对都面对这个问题,比如说左边呢。这个截图呢,就是我当时写的一个文章,可能大家看的不是很清楚。你看其实呢,这个文章中呢,记录了很多很多的一些嗯信息,但这些信息呢,其实一般的读者是没办法理解的,没有背景的知识,他根本就不知道我在说什么,乍一看是不知道的,然后你仔细看还是不知道,所以呢。这里呢,就。就是命中了这个知识的诅咒的这个问题。
19:01
那其实呢,于军他说过。他说用户不是自然人,是需求的集合,而我这边呢,衍生的一个概念就是说读者其实也不是自然人,而是需求的集合,而你要做的呢,就是要把你要写的内容和读者想要看到的内容建立一个桥梁和连接,所以呢,但是呢,我这个文章呢,就没有很好的去。呃,做一个很好的连接,导致呢,没有这个知识背景的人就完全看不懂,所以呢,我这个文章呢,其实是一个只适合我组内的同学看的文章,他都不是说我们部门的人甚至都不能不一定能看懂,所以他的他的那个受众面是非常窄的。所以呢,我们呢,写作的时候应该怎么去避免这种知识的诅咒呢?那其实呢,我们应该去尽量的摒弃这种限定上下文的信息,就是说,比如说这个限定上下文什么意思呢?就是说在某些背景,具有某些某些背景知识的同学,在某些场景之下,在某些限定的这种场景以及限定的这种框架之下,他才能够知道,知道的这些信息我们应该尽量的去摒弃,而应该要去用通俗大众的角度去去表述这个东西,对,所以我们应该去尽量的呈现这种通用的技术方案和思考。
20:09
最大程度的去扩大这种受众面,所以呢,我像我现在写技术文章的时候,我通常都会假定完全大家只只要是个技术人,他完全不需要具备任何的这种背景知识,都能够看懂这篇文章,我会用这样的角度去思考这个问题。所以呢,其实大家在写文章之前都要问自己几个问题,首先你写这个文章呢,你是想给谁看呢?你是想给领导看呢?还是想给那些小白看,还是想给技术专家看?你首先你要想懂这个问题。然后其次呢,你要想你这个文章呢,对大家到底有没有什么价值,如果说呢,你对大家没有价值的话,其实也没有必要去写。所以呢,其实刚刚也说过啊,费曼费曼学习法,其实检验知识的最终途径是你有能力把它传播给一个没有相关背景的人嘛,所以呢,我们要从这个角度来看,我们呢,要把读者当成小白,尽量的呢,不要去传递一些具有限定上下文的信息,而要传递一些通用的一些思考。
21:06
而金字塔原理,其实tops原理,它第一条就是target to your audience,其实呢,也就是说要从这个受众的需求点、关注点出发,只有站在对方的角度来阐述问题,才能达到这样有效沟通的目的。而一般的读者,其实他就只关心是什么、为什么、怎么办这三个核心的三三个核心的点。所以呢,其实这边的建议就是说我们要有一个临机思维啊,什么叫临机思维呢?临机思维就是说我们要放弃以前这个思维的存量,我要假设我不知道这个东西,我呢也是个小白,那我会怎么样去思考,我会怎么样去。表达,这就是灵机思维,但是大部分同学呢,都会站在一个我已经是一个认知比你高的一个人的这样一个层次上去讲,所以呢,通常呢,不能够很好的让读者。去听懂,所以呢,我们要尽量的去从灵机思维的角度出发,站在读者的角度去思考,讲清楚是什么,为什么,怎么办,这是一个这三个核心的问题,并且呢,最后写完之后啊,还要去找一些没有背景的同学检验,其实我写文章的时候通常会去找一些什么产品运营。
22:08
这些同学他们根本就没有相关的技术背景,让他们来看,如果他们大致上知道我这个文章大概在写什么东西,那我觉得这个基本上能算一个基本上能满满足我要求的一个文章了,对。那嗯,如果我们确定了这个目标读者之后呢,确定确定了我们目标读者之后,那第二个点其实就是攒素材了。那其实呢,大家会遇到一个问题啊,就是说我其实呢,呃有想法要写,并且呢,我也知道我要写给谁看,但是呢,我通常呢,就是。感觉到写不出东西,就像茶壶里煮饺子,肚里有货倒不出。那其实在我看来呢,这个情况呢,从项目的角度来说,其实一个很重要的一个一个原因,就是因为比如说我要写一个关于某一个项目的一个文章,其实最后为什么写不出来呢?是因为项目的周期啊太长了,到最后我真正去写这篇文章的时候,我早就不记得我当时的那些思考是怎么思考的了。
23:04
比如说我做这个东西,我为什么要去做,以及我为什么选了A方案不选B方案,这中间的选型啊,这个东西我早就遗忘了,所以呢,到最后我写的时候就是茶壶里煮饺子,有货倒不出嘛。所以呢,应要应对这种问题呢,在我看来其实就是要做好攒素材这件事情,攒素材这件事情呢,其实他核心的点就是说我需要啊,平时呢。去养成习惯,把一些思考的过程呢。以文档的形式记录下来。呃,其实呢,不用太过细致啊,一开始其实也可以,也可能会比较混乱,就比如说我我这边有一些文章,就是我其实其中做的一个项目的一个文章,其实他当时记录的时候呢,是非常混乱的,我们就可以把它称为碎片化的记录,他正在记录清楚所有的涉及到的重要内容。就是事无巨细,把我们当时思考到的一些东西和思辨的东西,包括一些选型的东西都给它记录下来,并且要不断的维护和整理更新。对于一个项目来说呢,如果不记录的话,随着这个时间的积累啊,你一定会忘记当时思考的很多细节,也会忘记一些决策的过程。
24:08
但是如果有记录在的话,你可以很很快的在最后的时候能够自己串起来,这其实是一个很重要的能力,这不仅对我们这个呃,写作。沉淀技术文章有很大的帮助,其实他对于晋级答辩一样是有很大的。Be的。所以的话,在我看来啊,你要写好文章,尤其是这种项目相关的文章,最重要的就是碎片化记录的一个一个过程,并且呢,最后呢,在进行一个结构化的整理,就是这样一个过程。那还有第二个点就是说,其实呢,要我们平时的时候要注意思辨。那有人说这个世界上人分为两种,一种是思辨者,另外一种是吃瓜群众啊,其实对于平时遇到的技术问题呢,我们多问一个为什么是一个很好的习惯,这种技术方案有没有经过深入调研?我们的方案是不是业界最佳的实践?它的本质上可以抽象成什么样一个技术问题,是不是可以应用于其他场景,这些思考呢,其实都可以成为我们后面写文章的一个来源,就是我们平时的一些思考,像这些思考呢,可能大家觉得这些都是理所当然的,但是对于没有接触过这个东西来说的人,他们并不是理所当然的,所以我们平时就要注意思辨,思辨的话就是我们要多去。
25:15
嗯,多去对比,然后多去探索,看看到底是不是还有没有什么东西可以挖掘,其实这种能力呢,就是我们写作的一个很重要的源泉。还有一个很重要的一点,就是平时不知道大家在做技术开发的时候会不会写这种设计文档,那其实在我们部门的话,设计文档是一个很重要的一个,呃评审的材料,每次要做一个项目之前呢,我们都要很好先写好技术文档,最后技术文档,最后去经过一个技术评审。那其实呢,这种技术文章呢,就是一个很好的以后的很好的一个技术文章的一个来源,所以我们呢,要以终为始。写好这种设计文档。因为我们在写设计文档的时候,如果以终为始的话,我我会以把它当做以后我们要写文章的一个来源,那么我们就会非常认真的去写它,非常认真的去记录它,并且呢,对于这个技术评审中的一些很重要的点,我们都会把它更新上去。
26:09
那这样子呢,这个技术文,这个设计文档呢,不仅它可以保持它的生命力,那最后呢,也会成为我们很好的一个技术文章的一个来源。所以呢,这边的建议就是说平时要去多去记录我们的思考过程,多思辨,同时呢,要认真的去写设计文文档,那另外一个点呢,就是我们要去写的时候呢,可以去参考一下同类的文章,比如说我要写一个rocky的MQ啊,或者是卡不卡的文章,我们就去看看。这个类型的文章别人都写过什么,那我们呢,有没有跟他形成一个差异化竞争?参考同类的文章,最后一个点呢,就是去请教我们公司的一些技术专家。那通过这这四种方法呢,其实就很好的去获得了我们写作的中间的一些主要的素材,那这是第二个步骤,就是展素材的这个过程。然后这边也给大家推荐几个我平时去记录这个呃,我的思考过程的一些软件啊,包括苹果的那个备忘录,其实我用的最多的就是平时想到什么问题啊,就会把它记录下来,还有notion啊,印象笔记啊,语句啊,这些都是用的非常好用的一些,呃,文档的一些。
27:11
呃,例子当然了,有这些东西呢,其实不代表大家就一定会去用好它,其实最重要的是大家养成这样一个习惯,去及时的把自己的思考过程记录下来,这个其实对于大家各个方面都是会有提高的。那第三个点呢,就是说定好题,也就是说其实大家很多人也会遇到这样的问题,就是说其实我已经知道我要写给谁看了,并且呢,我也呃有这样的素材,但是我就是没办法确定这个主题。所以呢,这里定好题呢,其实就是说我们怎么样去确定文章的主题啊。呃,这边有两两句话,一个是王羲之说的意在彼仙,然后还有庄子说的与之所贵者意,所以呢,这里的意呢,就是所谓的主题。那所以所以我们呢,在写文章之前,第一个第一个事情就是要确定好我们的主题,那这个主题呢,在我看来呢,有一些有一些嗯,使用的套路可以让大家去套的,其实如果我写文章的话,我一般都会用这六种思路去寻找我们的主题。
28:12
那第一种思路呢,就是呃,工作总结。工作总结,也就是我刚刚说的啊,就是我们平时做的一些项目,那这些项目呢,会成为我很好的一个这个文章的来源,那这个这种类型的文章的来源,他最重要的一个点呢,就是要注注意及时记录,就是把我们当时的一些思考过程,包括一些选型啊,给他及时的记录下来。那第二种类型的,呃,主题来源就是学习材料,也就是我们平时啊看的这些公众号啊,还有书籍啊,还有一些培训的那些,呃,视频啊,或者什么之类的一些演讲这种东西,这些学习材料,如果呢,我们要写一个文章,也是一个很好的。主题的灵感的来源。但是呢,这种类型的文章呢,就要找准角度,因为通常我们去形成学习材料这些东西啊,其实在市面上可能已经有很多同质化的东西了,我们怎么比如说卡夫卡rock MQ这样的文章,可以说是汗流冲动,那怎么样去写出一些新意来呢?这个就需要去找准一个角度。
29:10
就比如说我曾经写过一篇文章,是关于rockie MQ卡夫卡,还有还有帕萨的这个事物消息的一个文章,在内网发表的。那其实呢,写这三个组件的人可能很多,但是他们确确实实没有从这个角度上对他进行一个完整的一个剖析,所以呢,这个我就从这样一个角度去进行剖析了,最终这个文章也是挺受大家欢迎的,所以呢,从我们学习的材料中去挖掘这个主题的话,最重要的是找准一个好的角度,不要去写那种大家都平时都会去写的一些角度,嗯。那第三个角度呢,就是说从从一些热点话题上。那这个点就要求我们去多关心时事了,包括你看啊,我们现在恰gpt,或者是一些呃,AIGC啊,这些这些就是很好的现在一个热点话题,那么我们如果关心时事的话,我们就去关心时事,这里关心时事一方面是关心这个新闻,另外一个点是我们对一些新新的技术具有这种很好的敏锐度,同时呢也有很高的热情。
30:07
那我们就会去研究它,所以呢,这种热点话题呢,是自带话题的,所以。如果能大家能够把这个话题能写好呢,其实也是会非常吸引人的,这是第三个角度,第四个角度就是观察生活。那这个就要求我们呢,对自己的生活呢,进行一个细致的观察,包括我看过一些很好的文章,包括呃有篇文章,内网那篇文章,它是这样写的,就是平时的时候大家有没有注意到,呃自己的手机好像是感觉老是被窃听了一样,就被那些APP窃听了,我看一个东西,然后我自己还呃刚说过可能就他就给我推了类似的东西,那他这篇文章呢,就从这个角度出发,诶我平时有很多人都都遇到过这个情况,那从来没有人写过,他就从这个角度上去关去写他作为一个这个。资深的产品经理,他是怎么去看待这个问题,以及他有这方面的经验,他就可以很好的解答大家的疑问,所以呢,观察生活呢,就希望大家去细致的观察我们的生活,有很多东西呢,都是可以成为我们的很好的一个技术文章的来源的。
31:06
那第五个角度呢,就是深挖本质,这种文章呢,也是大家平时的时候看的特别特别多的一些文章,有些的文章呢,他可能不是什么热点话题,也不是一个学,呃,也不是学习材料,也不是工作总结,也不是观察生活,他可能就是就一个技术的问题深挖本质,比如说my circle的那个,呃,事物是怎么实现的,或者买circle的索引是怎么实现的。他就就这个事情把他从头到尾他的来龙去脉都给讲清楚了,那这样的文章呢,其实呢,也非常非常好的,可以成为我们的一些。很好的技术,呃,技术文章的标题的来源,那这个文这种类型的文章,其实最重要的是要求我们要具有一个逻辑思维,能怎么样去把这个事情的来龙去脉,他的这种呃原因和这个因果关系啊,给他呈现出来,这个情况呢,是很多很多的文章,虽然他都只讲这个东西,但其实他们根本就只讲了本,可能只讲了那个现象,没有讲本质。
32:00
你没有把把这个这种思维过程给呈现出来,那么如果你能够把这种思维过程呈现出来,那这个文章也可以成为很好的技术技术文章来源。那最后还有一种很特别的例子,就是巧用对比,当大家在刚才那五种思路里面都找不到思路的时候,我们可以用一种巧用对比的类型。强对比类型,比如说诶,我刚刚说的那篇文章,对比这个,呃,Rockie MQ啊,帕萨,还有卡夫卡,他们之间的事物消息有什么异同,包括有我看过一篇文章,它是讲腾讯的技术体系和阿里的技术体系,它有什么不同,像这种对比啊,其实他天然的就会有一种冲突感,所以呢,他就会很好的去吸金,让大家对这个话题有兴趣,所以呢,但这种话题呢,就要求大家有一种辩证思维。大家要平时多去训练自己的辩证思维,怎么样去从不同的角度去看待这个这个事物,怎么样去对比,所以呢,这种对比类型的文章,也是我们一个主题的一个来源。所以呢,我们如果说我们真的不知道怎么去获取来源的时候,大家不妨从这六种。
33:03
角度去思考一下,看看自己有没有相关的一些话题可以写,那么我认为什么样的话题呢会值得写呢?首先你必须要有分享欲,刚刚杨老师也说了,如果这个文章你自己都不想写,没有这个热情的话,那就不如不写。所以的话,写文章的一个首要前提就是你自己有分享欲,然后第二个点呢,就是文以稀为贵嘛。就是同类型的文章市面上非常少,不管是内网还是外网,如果都非常少,那这种文章呢?他通常呢,他就会成为一个潜在的好的文章的来源,所以呢,文以稀为贵,希望大家写的这个东西呢,是尽量有少有人写的,然后第二第三个很重要的点就是对他人有价值,比如说我,我自己非常有分享欲啊,同样同样的我写的这个文章也确实没有写过,但是呢,其实他对大家没有价值,只是自嗨,那这个东西也不能成为一个。我称之为一个值得写的话题,那所以呢对他人有价值,这是一个很核心的点,所以呢要有一种利他的思维,所以我们如果认为一篇一个主题,我们认为他我自己又有热情写,同时呢也写的人很少,同样呢也对他人很有价值,那么我们认为这个就是一个好的主题了,大家就可以放心的去写它了。
34:09
那这里有个小建议啊,就是灵感的获得是具有偶然性的,比如说我当时有一个灵感,诶,我要写篇文章,可能过了一天我早就不不记得了,所以如果大家有一些很好的写作灵感,希望大家能够养成,其实记录的习惯还是跟刚刚一样,如果我们有一些很好的主题,如果只是闪电一间的话,我们希望可以在我们的那个笔记本上记录下来,这样子的话,后来我们写的时候呢,就会,呃,再再把它拾起来,对。那讲完了这个定主题,当然接下来我们就开始去,呃,做一个很重要的步骤,就是搭骨架。那其实呢,很多很多同学呢。其实都会在这个问题上遇到,遇到问题了,就是我们已经开始要决定要写一个主题了,但是这个时候呢,其实我们不知道怎么去谋篇布局,这个是很多一个很实际的一个问题了。所以呢,关于这个步骤,其实就是说白了就是先写什么后写什么,怎么开头怎么结尾的一个问题,这个问题呢,是一个非常非常实际的问题。
35:05
而我们写作的时候呢,一定要先确定我们的目录结构,再去填充内容。包括这个出书其实也是一样的,我们先要有一个大纲,然后再去再去填充这中文内容,其实写这种技术文章也是一样的。我们要先去确定这个目录结构,然后呢,再去逐步的去把它完善起来。那这边呢,推荐了两大利器啊,第一个利器就是金字塔原理。金字塔原理其实它是一种重点突出,逻辑清晰,主次分明的一种逻辑思路,表达方式和规范动作,它不仅可以用在写文章上面,在很多利域领域上都可以用得上,比如说PPT上面或者思考上面都可以用得上,那其实呃,金字塔原理它其实有四大原则,这里嗯,可以一一的说一下。第一个就是结论先行,结论先行就是说我在写,我写一篇文章的时候,我们首先会有个导语嘛,我们会把我们的主要的一个思路先给大家描述一下,同时呢,我们写每一章的时候,我们也最好呢,去把自己的主要的结论在开始的时候抛出来,然后呢,以上统下,就是说我们的主要内容呢,应该是。
36:10
内句的有一个,首先我们那个章有一个章标题节又有个结标题,那希望这几个节呢,是跟这个章是有关系的,而不是说我们突然之间列几个,呃,完全没有相关的东西去填充我们这样一个结构,所以的话,我们的文章呢,是希望像一个金字塔一样,以上统下的一个结构。然后呢,还希望呢,我们这这样一个文章呢,是需要具有一个分级的一个结构的,并且呢,逻辑呢是可以递进的,这个应该大家可以理解了,我们作为写一个文章的话,我们不希望每章每节之间是割裂的关系,他们之间应该是。形成一个整体,每一章下面有多少个节,这个这几个节呢,是去形容这个章的,那最后呢,每个章节之间呢,又有一定的过渡关系,这样子呢,才能让大家成为觉得你的文章呢,是浑然一体的。所以呢,最重要的是要把你的思思想观点呢,组织成一个金字塔的结构。
37:02
那这边有一些建议啊。就比如说观点先行,就是说我们在导语和这样的一个开篇中就亮出观点去吸引作者。然后呢,先有提纲,就是说我们要先列出目录,再去写内容,承上启下,也就是说我们每个段落之间啊,要做合适的过过渡和转折,然后结尾升华呢,就是说我们在文章的末尾要去总结全文,升华这个主题,拓展思考,那这样就是一个我认为符合金字塔原理的一个一个创作的一个过程。那第二个,呃,第二个这样的一个利器呢,嗯。第二个例题就是说任何一篇文章呢,其实它都是结构化思维的产握,很多人觉觉得写东西太难,其实它的真结不是对于文字的把握,而恰恰是对于嗯,缺乏对于思维结构的把握,所有的文章呢。他必须要有中心思想,所以呢,这就其实就是一个结构化思维中的确定目标。为了表示这个中心思想呢,必然会分段陈述。
38:00
那各个段落都有各自的段落大意来支持这个中心思想,这就是结构化思维中的资源分析。所以我这章这章PPT要讲的主要是一个结构化思维的问题,其实就是很多同学遇到这样没有结构化思维会遇到什么问题呢?就是我们写着写着写不下去了,或者直接就跑题了。其实他就是结构化思维训练的不足啊,那这边其实也有关于结构化思维的书籍,大家平时的时候也可以去多去读这样的书籍,怎么样去书去训练我们的结构化思维,这种思维呢,是我们写作,包括做PPT中间一个很重要的思维,是一个很基础的能力啊,那结构化思维的本质呢,其实就是信息熵,怎么样去把我们的信息商降低,把我们的知识的有序度最大化。那这边呢,对大家的建议就是说,首先要自上而下,我们要去先去讲观点,再去讲事实,最后讲数据,然后层次清晰呢,在一个章节内呢,就要把相关的议题说清楚,分清楚议题的层次,然后呢,结构要比较简单,表达结构。不宜太过复杂,重要的事情只说三点,最后呢,重点突出,不要去传递过多的信息,我们要有一个原理叫奥卡姆剃刀法则,我们要尽量的去把我们最想传递的信息突出出来,所以呢,这就是结构化思维的一个核心要点。那么我觉得写作文章中间怎么去应用结构化思维呢?第一个点就是头脑风暴,我们把所有的想法呢进行一个穷举,然后第二个点呢,我们把穷举后的这个想法进行一个分类归纳。
39:18
筛选出来我们要写的一个核心的要点,最后呢,第三个步骤呢,就是基于这个分类去提炼标题,每个章节的标题,最后呢做一些补充,这个就是结构化思维的一个用来搭骨架的一个主要流程。那这边的话,嗯。骨架已经搭好之后,接下来我们写文章的过程中,有一个很实际的点啊,就是说怎么样去画好图,也就是怎么样去画好我们的插图,因为大段的文字通常大家都读不下去,人脑处理文字和图片,图片信息是有区别的。处理呃图片的速度大概是处理文字的6万倍。所以呢,大家一定要在写文章的时候啊,去利用好插图这个利器。因为大部分人都是先看图再看字,哪怕这个图里面只有字,也就是第一张图片,然后呢,文不如树,树不如表,表不如图,因为人脑处理图片的速度啊,是处理文字的6万倍,比如说我下面这篇这个这个图图片啊,其实它表达的是一个很复杂的业务场景,如果大家要写的话,相信要费非常非常多的字去写,但是我这张图呢,就可以很好很简洁的把这个业务场景给他说清楚,这个是文字不可以替替代的一个效果,所以呢,配图呢,不一定是我们的配角,人们在看报纸的时候呢。
40:26
百百分之九十九的信息都会被自动过滤。过滤掉。所以呢,配图其实他不一定是配角,他可能会成为我们文章的主角啊,那这边也给大家推荐几个画图的一个利器啊,包括PPT啊,还有cage,还有。One呢,这些旧点IO,这些都是我平时非常用的非常多的一些软件,大家平时也可以多去试用。所以呢,这里想给大家强调的一个重要的观点就是意图胜千言。那这个点呢,就是说我们怎么样去写文章,其实它最重要的点,说1000道1万,决定一篇文章质量最重要的因素还是有干货,言之有物啊。
41:02
那这边有四个建议,第一个建议呢,是写文章的时候尽量要在更高的抽象层次上进进行写,避免去描写过多的技术细节,要上升为方方法论。第二个点呢,就是在自己熟悉的专业领域写作,避免传达错误的信息,要体现自己文章的专业性。第三个点呢,就是要有深度体现出来我们在这个领域的全面掌握,要把这个上下游信息都给它串联起来。第四个点呢,就是要加入我们自己啊,基于自身实践的理解,而不是仅仅做一个翻译者,这样子的文章呢,我们认为呢。他才是一个有干货的文章,对。那最后呢,我们写完文章之后呢,可能我们文章有干货,也有图片,也有很好的框架,但是呢,他语言晦涩,排版不好,也会导致我们的文章没有人可以读得懂,所以呢这边呢,就会建议大家写文章最后要进行一个润色,润色主要从三个角度来进行润色语言章节和排版,语言呢我们要尽量追求精简,准确和生动。也就是让我们的语言呢,尽量能能大部分人都能够看懂,不要产生歧义,并且呢,很简单,很生动,让大家都有兴趣读,章节呢,要追求我们的章节的连贯和过度,自然写一章一节之间呢,都要写一些过度的句子,去帮助大家进行一个思维的过过过度,不要进行大范围的一个跳跃,那排版呢,就是说有四个建议啊,比如说不同级别的标题呢。
42:20
我们不同的级别的标题呢,不要超过三层,每个章节之间的长度要适中,并且呢句子呢不宜太长,尽量的多使用标点那。写完之后呢,要进行通读,避免一些错别字,这个是很低级的错误,所以我们写完之后自己要通读几遍,并且让一些同事先读几遍,这样子呢,就可以避免一些很低级的错误啊。那我们希望写文章的要多迭代几个版本,反复的像打磨自己的代码一样打磨自己的文章,这就是我们说这个润色的一个过程啊。那我这边也把一句话送给大家,就是我我的领导送我的一句话就是把复杂的东西讲简单,把简单的东西讲深刻,其实都是比较难的事情。
43:01
那最后一个点呢,就是练内功啊,就是我们写完的之后呢,我们希望大家多去看一些我们论坛上的文章啊,包括各个论坛上,那尤其是推荐我们的腾讯云开发社区啊,对这边左边的最左边的这个截图就是我们腾讯云开发者的社区,大家在这些文章中呢,就可以。呃,学到很好的行文习惯和写作思路,那这样子呢,其实呢,也是也就是对我们写技术文章是非常有帮助的,所以呢,希望大家在平时的时候多去阅读,嗯,那我这边的内容基本上就到此结束了。这边呢,就是我今天主要讲的内容,那接下来就会进入一个QA的环节,谢谢,感谢若雨老师的精彩分享,相信大家对于技术写作都有了更多的认识,大家一定有不少想交流的问题,现场的同学可以举手示意我们的工作人员迪妈,好,那我提一个线上的问题吧,线上有一个小伙伴问文章的段落如何划分和组织?呃,文章的段落如何划分组织,其实呢,还是刚刚回到那个,就是刚刚那个搭骨架那个环节,其实他就是。
44:06
嗯,一个其实它体现的就是你会不会运用这种金字塔原理和那个结构化思维的一个过程,那其实呢,在我看来,其实写文章呢,应该是一个有一个有一个基本的套路,其实他就是先写啊,为什么然后呢写。怎么做,最后呢,写是什么这样一个,这样一个,你通过这样的一个思维习惯呢,然后最后呢,去把这中间的。每个段落进行不断的拆分,比如说我写一个关于资金系统的一个话题,那我首先肯定要去把这个资金系统这个概念给大家呈呈现出来,以及我为什么要去做一个资金系统,那后面呢,谈到资金系统怎么实现的时候,也就是号。怎么怎么做的时候呢,那我们就想这个资金系统要做的话,其实他就只有两个技术要点,一个就是可用性,高可用性,第二个点就是资金安全,那从这两个点去进行衍生呢,又会衍生出来很多子的一些一些话题,那我们就可以在这个子的话题下进行扩展。
45:02
就是通过这样一种呃,结构化思维或者金字塔原理去把我们这个段落进行划分。感谢老师的解答。还有一位线上的小伙伴问老师,写作应该写浅显点的内容还是写深刻的?浅显的内容看完容易被忘,深刻的内容又容易又不容易被人看懂。那其实刚刚刚刚送给大家那句话,其实就是很好的回答了这个问题。其实。呃,怎么说呢,就是你如果能够把一些。呃,很复杂的内容,把它给讲简单了,然后把一些简单东西讲深刻的,其实这是需要能力的,就是这种能力呢,是需要不断的锻炼,所以呢,其实我我认为。并不是说嗯。深刻的东西大家就一定不懂,而是你怎么样用你的方法去把这个深刻的东西给他讲简单了,同样的,简单的东西呢,也并不代表它没有价值,你怎么去把这个简单的东西呢?给他讲出来他的那个抽象出来他的那个思维高度。
46:01
怎么样能让大家去感受到这个东西,其实并不是那么简单,其实这个都是一种能力,所以的话。我这边认为呢,就是如果你遇到一些很复杂的问题呢,你就要想办法把它进行简化,能帮助大家理解。如果呢,你遇到一些。可能是小白。都会,呃,都会遇到的一些技术问题,可能没有那么多,那么高的技术深度,那怎么样去抽象他的思维层次,把他的方法论提升,能让大家觉得这个东西是被你讲的很深刻。那这就是我觉得比较重要的点了,对。
我来说两句