程序员的写作课:一、关于技术写作的那些错误思想

栏目: IT资讯 · 发布时间: 6年前

内容简介:破山中贼易,破心中贼难 —— 王阳明在正式开始我们的课程内容之前,我们先来聊一聊技术写作过程中,你会遇到的那些错误的思想,让你对技术写作有所改观。写作是属于我们向世界表达看法的工具,它属于每一个人。你写一句话也是写作;你写一段话也是写作;当你开始写的时候,你就已经在写作了。

破山中贼易,破心中贼难 —— 王阳明

在正式开始我们的课程内容之前,我们先来聊一聊技术写作过程中,你会遇到的那些错误的思想,让你对技术写作有所改观。

1. 我们搞技术的人写不来文章,那个是运营(文案)的活

写作是属于我们向世界表达看法的工具,它属于每一个人。你写一句话也是写作;你写一段话也是写作;当你开始写的时候,你就已经在写作了。

不要畏惧写作,写作是我们必备的技能,在职场中,我们经常要写周报、年报,在家里我们偶尔要给老婆写一下感言,这个东西我们必需,所以我们必练。

对写作重视起来,然后开始写吧!

2. 技术写作文笔不重要,干货才重要

不少 程序员 在写作时不甚用心,可以理解,毕竟大家工作那么忙,总是996,哪来的时间写作呢,但是, 时间不足不意味着你就可以认为「内容重要,文笔不重要」

首先, 文笔也是内容的一部分 ,当你说出内容重要文笔不重要时,你就将文笔与内容割裂开来,在一开始就出现了错误。

其次,对于文笔,我们的确不应该以专业作家的要求来要求普通的程序员,但是不意味着你可以完全不在意文笔,甚至以文笔好为耻,认为那不是一个正经的「程序员」。写作与每个人都有关,与职业无关, 我们每个人的文笔不可能都做的非常好,但是,我们可以让自己的文笔在自己所能做到的极限中,达到最好

最后,文笔的好坏往往以修饰词出现的多少,语句之间的起承转合的流程与否来进行评判,这使得文章中出现了大量的与核心思想本身无关的内容,固然让文字显得「水」了一些,但是,却能让你的文章的可读性大大的提高,不再晦涩难懂。

所以,想要写好文章,首先,别拒绝文笔。

3. 技术文章只要干货多,就是好文章

干货是我们经常评判一篇文章好坏的标尺,对于干货较多的文章,我们会点赞,对于干货较少的文章,我们就会唾弃。

但是,在写文章之前,你需要先考虑你的文章的受众,再进行干货的排布。

面向高级工程师和初级工程师的文章对于干货的需求必然是不同的,如果你错配了需求,干货再多,也会被读者吐槽。

一个比较典型的例子是,当你需要写给初学者看的时候,干货异常丰富的官方文档可能并不是一个好的选择,太多的干货带来的巨大信息量会让初学者在一开始整个信道就被占满,无法进行内容的学习,同时,还会在一开始给他巨大的学习压力。个人写的教程、视频教程则相反,抽离出最核心的内容,并对内容进行排布,让初学者可以很轻松的就进行内容的学习。

但是,我们在写文章时,不能为了更好的可读性就一味的降低干货的量,所以,面对初学者的文章时,你除了尽可能的简化你所能提供的信息,还需要平衡干货的量,这一部分,我通常是以 参考链接延伸阅读 的形式来完成的,帮助读者更好的去学习所学的内容。

4. 吸引眼球的标题不是好标题

标题只是一个工具,真正令人讨厌的不是标题,而是标题背后的那个人。

我们每个人都讨厌标题党,但是我们不应该讨厌一个好的标题。标题党的主要行为是「发帖的标题严重夸张,帖子内容通常与标题完全无关或联系不大」,让我们有较高的期待和随之而来的较大的失望。但是从功用的角度来说,他们的标题很好的完成了自己的工作,将人们吸引进来。

在信息充裕的时代,我们往往会通过信息流来选择自己想要看的内容,这个时候我们必然不能通过阅读每一篇文章来选择,那样就不是选择,而是遍历了。在这个时候,一个好的标题,能够帮助你更好的吸引读者进来看,让你的内容能够从众多的文章中脱颖而出。

我们应该合理的利用好标题吸引读者进入的功能,来为我们的文章选择更多可能的读者。

5. 写作只是写就可以了

写作不单纯是写,写只是写作中最后一个环节。

写作的完整流程应当是「输入」- 「处理」 - 「输出」,你写不好文章的问题核心不在于「输出」,在于输入,没有海量的输入,你很难获得持续、高强度的输出。没有中间的处理,你所能写出的文章就是一篇流水账。输入是阅读,你需要海量的阅读;处理是思想,你需要先在大脑内进行思维的碰撞,找出自己想法中的合理与不合理。输出是成文,将处理的结果整理成一篇洋洋洒洒的文字。

如果你对本文有什么看法,欢迎你在文章下方评论,或扫描二维码,加入知识星球参与讨论

程序员的写作课:一、关于技术写作的那些错误思想

以上就是本文的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助,也希望大家多多支持 码农网

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

数据压缩导论

数据压缩导论

萨尤得 / 2009-2 / 99.00元

《数据压缩导论(英文版·第3版)》是数据压缩方面的经典著作,介绍了各种类型的压缩模式。书中首先介绍了基本压缩方法(包括无损压缩和有损压缩)中涉及的数学知识,为常见的压缩形式打牢了信息论基础,然后从无损压缩体制开始,依次讲述了霍夫曼编码、算术编码以及字典编码技术等,对于有损压缩,还讨论了使用量化的模式,描述了标量、矢量以及微分编码和分形压缩技术,最后重点介绍了视频加密。《数据压缩导论(英文版·第3版......一起来看看 《数据压缩导论》 这本书的介绍吧!

在线进制转换器
在线进制转换器

各进制数互转换器

UNIX 时间戳转换
UNIX 时间戳转换

UNIX 时间戳转换

RGB HSV 转换
RGB HSV 转换

RGB HSV 互转工具