技术类文章的三个类型

572 阅读5分钟

前言

如果要写一篇文章论述某主题,先想好分类是什么,这个问题很关键。


本文思路

为什么

分类的好处

  • 方便快速定义或者搜索某文章是不是你需要的,或者你有必要写的
  • 便于知识沉淀

不分类的现状

  • 写一篇是一篇,一般是按照时间维度的松散分布
  • 文章之间没有任何关联性,很难建立系统化的知识与技能
  • 不方便搜索,需要时还是从0开始的居多

分类有哪些

系统化的教程&&学习笔记


这类的教程其实有很多,在程序员日益成为一类特殊群体之后,我们见到的系统化的教程分为下面三大类:
1 这门语言或者框架提供的官方教程,一般是入门级别,个别的会提供 一些编程思想。
2 大咖的技术博客或者某些公开的教程。当然也包括某些知名作者提供的相关入门书籍。
3 一堆的教学网站,乐此不疲的为广大入门程序员提供api教学,并录制视频。

然后就会有一批的学生写学习笔记,做项目,彼此大同小异,除了官网抄一遍,有的会个别说些自己的理解。

实践


一旦开始实践,就会发现前面学的真的只是入门,实际上还有各种问题在等着你。

1 上手问题以及经验


从0开始,直到用这项技术完成了一个或者一类需求,从中见到并解决了一系列的问题,包括环境配置、准备工作、通过上手的不同细节对比,给出更好的上手建议。善于学习的人,同时会给出上手的这类技术的边界,适合解决什么问题,可以帮助进行初步的技术选型,判定学习成本

2  某问题或者需求的经验


但一定是有很多仅仅靠官方的api完成不了的,为什么呢?原因是多样的,可以随便举出下面的几种常见的:

  • 官方的举例一般都比较简单,实现的仅为单点需求的解决,而实际业务有些比较复杂,需要设计过
  • 某些官方未标明的细节问题,或者bug,需要一定的写法或者补丁才能弥补
  • 官方未提供类似的解决方案,需要第三方模块或者自己造轮子
  • 属于多领域技术的结合问题
  • 涉及原理层面的问题,仅仅是知晓api解决不了的

系统化解决方案


当你觉得某分支领域或者主题下,已经完成了基本的入门,并完成了基本的实践,解决了大部分的问题,你一定有了比较多的积累和心得。可以综合这三者总结出系统化的解决方案。

方案可以是一个新造的技术轮子,比如一个系统或者模块,也可以是一种规范,总而言之,通过这种方式,可大程度的解决一类问题,或者排查或者分析一类问题。

如何写出这样的文章

时间维度上


不管怎样,确实不得不承认时间维度是我们最容易接受的维度,所以你可以以日记的方式记录一天的收获,以及点点滴滴,如果你觉得这样比较乱,可以自定义一些模板,然后以方便整理的数据模板的方式进行记录。

主题上


当一个时间周期内,我一般定义为一周,觉得对某些主题有一定的收获了,可以把与这个主题相关的内容摘录到一起,做内容的精简与串联。

深度、难度


当主题上的内容你发现可以分为入门、进阶、架构不同层次时,再次针对同一主题的内容进行分档,挑选出你认为不同级别的人更适合看,更适合实践的一些内容。

我的实践


我写的一篇比较好的系统化解决方案的是关于前端web字体的,其实前端入门第一课基本都会有如何使用不同字体,但随着不常规字体、web font的诞生,以及不同的特效字体和展示差异,涌现除了越来越多的问题,所以一篇比较刚需的前端字体使用通识有必要总结出来了。

原文链接:项目字体规范

那么我还是继续回到话题,如何写类似的文章,下面分别说明下

1 如果说是常识或者说知识,你在某场景下知道了某个知识点,或者某需求实现技巧,用案例也是 ok的,这种就可以写常识或者知识类型。比如你知道了webfont字体,那就要知道如何使用,如何维护,其优缺点是什么。告诉别人你是如何用的。

2 如果是异常,比如设计师做的某字体为什么在用户的设备上显示不正常,就要表明现象,原效果实际效果,用的字体是什么,设备是什么,然后就这个点询问前端的实现思路,设备上如何显示某字体的逻辑,然后找出你的方案来,方案一,这类问题没法解决,如何避免,方案二,这类问题可以解决,正确的使用方式和限制条件是什么。

3 如果是web字体通识,你应该基于这个主题做发散思维,思考概念,分类,基本使用,分布情况,收费情况,显示效果,建议内容,常见问题等。

更多


你有如何整理一些文章的思路么,欢迎分享。

备注:当然还有很多类似于面经,某某原理分析,但你可以分类与上面的大的分类,归根到底,我们还是要有系统化的知识和领域解决方案,这是本质。