18boys/blog

这是我的博文总集,欢迎star!

blog's Issues

技术写作初学者的常犯错误

技术写作有诸多好处,比如说能巩固自己的知识体系,提高阐释技术问题的能力,建立自己业内的影响力等等.此处我们来探讨一下开始写作的时候,避免一些常见问题.

1.忌贪多嚼不烂

总结的知识限定在聚焦于一个范围内,这是是一个比较好的写作实践.最好不要没有边界限制,大大拓展文章内容,导致文章主体不够突出,失去了重点.往往拓展的越多越不容易讲清楚.
比如说我们讲解获取页面滚动高度为0的问题,只需要讲解pageYOffset,scrollTop即可,分别在什么场景下使用这两个属性,怎么使用.
最好不好拓展开始讲解起clientX,screenX等和长度有关的属性,更不用说再拓展出来一篇关于js长度属性的文章.且不说这些东东适不适合杂糅写在一篇内容里面,从涉及的点太多而言,可能会让讲解失去了重点,乃至讲解不清楚.另起一篇文章来阐释其他问题的做法更为恰当一些.

2.小处着眼,忌眼高手低
最近四五年mvvm的框架如雨后春笋般出现,最近已经形成了vue,agular,react三足鼎立的局面.网上关于双向绑定,数据绑定,脏检测,虚拟dom-diff算法等文章层出不穷,这些文章会讲解一些高大上的面试会问到的知识,满足了前端从业者知识快餐的需要,大家研究这些高大上的知识的热情不断高涨,每次面试都会挑灯夜战,仔细复习这些内容.
如果开始写文章就直接这些高级的前端知识,对类型检测,继承等知识不屑一顾,缺乏耐心的话.长此以往,会导致自己的知识体系如空中楼阁,根基不稳,后劲不足.
所以如果是初始开始写文章我更倾向于从小处着眼,穿插框架的原理知识,小处为主,切忌眼高手低.等基础知识夯实,再将大部分精力放在框架原理知识,会事半功倍,水到渠成.

技术文章新手切记这两个问题,以 '小少精' 为目标来开始技术文章的书写.