作为一名技术编辑,经常遇到很多热爱写作的小伙伴提问:写技术文章究竟有没有方法论?怎么写读者才更喜欢?
今天是高考的日子,大家回想一下高三备考时,语文老师提供的范文、给出的文章结构,让大家背诵的段落……这些,都是在教方法论。由此可见,写作必然是有方法论的,那么写技术文章也必然是一些有方法论的。
本文就为大家简单地介绍一下选题方面的“方法论”。
一、作为开发者,究竟为什么要写技术文?
首先,建议大家要对自己对写作有一个清晰的定位。作为开发者,写技术文的目的,无非是以下几种:
- 沉淀所学;
- 分享经验;
- 提升自身影响力;
- 自媒体变现;
- 老板考核要求。
如果定位仅仅是沉淀所学,那么对作者来讲,提升原创内容质量很难。因为这样的定位,所产出的内容基本上是《某某书籍读书笔记》、《某某技术学习笔记》、《某某图书摘录》。这类文章对于作者本身学习是非常有用的,俗话说“好记性不如烂笔头”,如果能做一些笔记和摘要,对自己掌握某项知识是大有裨益的。但是这类内容很难出彩地吸引到大量读者,而且某些时候还会涉及到版权问题,很难被推荐。
如果定位是分享经验,在日常工作中积累自己的技术经验,在学习过程中系统地总结知识,然后加入自己的深入理解,最后条理清楚地分享出来,对作者的要求就会明显提高。长期坚持下来,作者的原创能力会明显提升,文章质量也会随之提升。
当然,也有很多人打着分享经验的旗号,纯粹是为了自媒体变现、完成老板的考核要求,这类作者对文章质量要求就如同对待工作一样,参差不齐。有人会朝着“震惊!”“必看!”等标题党方向发展;有人会在网上搜罗各种开发者段子;也有人会非常认真对待,因为觉得是一项重要任务。
其实,不断学习总结——>沉淀自身思考——>清晰分享经验——>获得影响力提升——>实现自媒体变现,才是正常的发展路径。从我打交道的多位专家、优秀作者来看,基本都是沿着这个路径成长起来的。
最纯粹的技术分享,往往能够带来多种收益;只为追名逐利,往往会急功近利,焦躁不安,东拼西凑,原地踏步。
二、从几个标题浅析技术文的选题
我们将写作定位到技术分享之后,再来一起看看技术文的选题。
现在的互联网上,技术文再也不是稀缺资源,很多开发者都加入了写作的队伍。但是优质的内容,依旧很少。此处罗列一些技术文标题,给大家感受一下(无意冒犯作者,部分标题经过修改):
- 《下载视频失败》
- 《我的开发笔记》
- 《一文掌握快速排序》
- 《还不会写红黑树,是准备家里蹲吗!?》
- 《Android面试题基础:应该都会的呀!》
- 《给所有入门编程的人几个建议!!!》
- 《拿过校级“一等奖”的开发作品》
- 《某软件的安装步骤》
- 《分布式架构设计:柔性事务之Saga详解》
- 《运维数据生态:高阶落地的一些场景》
- 《大型前端如何分析用户行为》
- 《B站高可用架构实践分享》
- 《美团万亿级 KV 存储架构与实践》
单单从标题来看,我们简单分析一下:
标题1,很难判断是要讲什么内容。首先,不清楚是什么情况下遇到了这个问题,是普通用户遇到的,还是开发同学遇到的?解决了什么问题,对开发者来讲有什么借鉴意义?
标题2,也难以判断是什么内容。首先,突出“我”这个人,但也不知道是不是某知名大V,读者不太感兴趣。开发笔记,不知道是移动端开发呢,还是后台开发呢?还是上学的时候开发一些demo呢?时间节奏紧张,很多读者也不会浪费这个时间打开去看的。
标题3、4、5、6、7、8,从标题上就能判断都是面向学生群体或者基础薄弱群体的。尤其是基础算法类的解读,网上有大量的同类内容,一线开发者很难感兴趣。
标题9、10、11、12、13,从标题上能感知到这是面向哪里一线开发者群体的,如果文章大纲清晰、内容丰富,能够给一线开发者借鉴,那么就是非常典型的优质经验分享文。
其实,优质的技术文,重在讨论技术经验。结合开发者的工作特点,能写的选题方向并不是很多。这里帮助大家列举一下,都哪些常见的选题方向可以写,大致的结构如何,便于大家在没有思路的时候“对号入座”,同时给出一些我编辑or约稿的文章,以供参考。
1. 需求实现类
此类内容,重在介绍实现具体业务需求过程中的技术实践。要让读者能够在了解背景的情况下,了解作者的思考过程、具体实践、实践结果。
典型的文章架构:
- 介绍业务背景,分析业务特点
- 技术选型过程,讲解选择原因
- 架构设计方案
- 重点问题解决
- 总结
《百亿级微信红包的高并发资金交易系统设计方案》
《鹅厂的这波青年,自发搭建了一套分布式大气监测系统》
2. 技术优化类
代码优化、架构优化、工具优化等技术优化总结,需要让读者明白,什么要做优化,怎么做的,最后效果怎么样,如果可以的话,还可以进行升华总结,指出哪些特定环境可以采用同样的优化效果。
典型的文章架构为:
- 背景介绍,重点介绍技术急需升级的原因
- 技术选型
- 总体设计
- 细节设计
- 效果总结
《QQ音乐PB级ClickHouse实时数据平台架构演进之路》
《bilibili技术总监毛剑:B站高可用架构实践》
3. 理念实践类
对某一技术方向、架构思想,或者说是技术理念的实践。
典型的文章架构为:
- 技术理念的诞生背景
- 技术理念的发展现状
- 能解决什么实际问题
- 实践过程的落地方案
- 总结与展望
《韩欣:企业微服务技术中台落地实践》
4. 技术盘点类
对某一时间段技术发展的盘点,既是盘点,重点在于全面、客观,可以适当加自己的观点,但不要过于偏激,否则容易引起骂战。这是我几年前约的一篇稿子,经过打磨后,在当年还是比较受欢迎的:
《2016 前端开发技术年度最全盘点》
5. 技术介绍
说明:从开发者的角度分析技术发展,或深入浅出地介绍某一项技术,对作者水平要求较高。
参考文章:
《三次大浪潮推进的AI背后对应哪些技术? | 产品经理眼中的AI简史》
《Serverless 基本概念入门》
6. 趋势预测类
说明:对某项技术对发展趋势预测,但是对作者对趋势对判断要求较高。
参考文章:《Serverless,将给前端发展带来大变革的技术?》
7. 团队成长类
主要说明如何进行团队管理,也算是为技术发展服务的,所以也归位“技术文”。
其实,技术文也不仅仅是以上的这些分类。很多技术同学也会配合运营团队产出包括产品介绍类、重大发布类、KOL采访类、产品实战类、活动通稿类……多种文章。也有漫画类、杂谈类等类型的文章。
三、小结
技术文的优劣往往能够直接体现出作者开发水平的优劣,技术文究竟好不好,重点还是在于是不是好技术,是不是能够给读者带来好的经验、好的思考。
如果大家有感兴趣的话题,比如:技术文撰写应该注意哪些细节?究竟如何为技术文起一个好标题?如何出版技术图书?都可以在本文下留言,我会为大家做相应的总结整理,或者邀请相关的专家来为大家解答。