技术文章写作指南

前言

首先,由于自己平常是会做一些总结,会对一些比较基础的知识进行总结,包括这次自己在工作中用到了OpenCV,所幸,自己在之前有花时间学习了两个月的时间,但感觉甚至没有这两周的时间对这些算法的理解透彻,确实有些事情还是要在项目中,在工作中去驱动,才能更快的掌握啊。晚上刚好有时间,也不想去刷题,就看一看之前有哪些文章,自己保存未读的,拿出来看一看,就看到了这篇文章,确实感觉还不错,值得推荐,有些观念确实比较深入。就是这篇读书笔记: 技术文章写作指南
还有就是自己平常对知识的总结,感觉都没有加上自己的理解,自己对知识的串联,这是自己要加以学习的点,不要只顾着总结知识,而是要串联知识,写下感悟,这才能真正锻炼自己的思考能力。
确实,现在还记得朱伟讲的一句话: 少一些功利主义的追求,多一些不为什么的坚持

正文

读书笔记: 技术文章写作指南 感悟笔记

  1. 支撑写作的要素?

首先要有输入,输入的质量高且有效果。
训练思考能力:习惯追求事物的本质,习惯建立知识的链接。
强化输出: a. 天天写。 b. 文章中有故事又有观点。 c. 建立自己的写作流程,固定套路。 d. 建立反馈系统。

感悟: 确实,人一定要有一定的输入,并且这个输入的质量一定要非常高,并且自己要有相应的理解,才能更好的阐述其中的道理以浅显的形式让他人理解。 并且,其中的链接性更需要自己对知识的博学,才能很好的链接很多东西

  1. 为什么必须公开写作?
    a. 人是社会动物,有压力有反馈。
    b. 点赞少说明没得到别人的认可,阅读少说明你的话题不是大家关心的话题,评论少是你没调用作者参与感。

感悟: 感觉自己只敢在博客上写写文章,自己的内心还比较脆弱,怕他人的批评,也怕误人子弟,所以,很多知识一直在以引用的形式,除非,这套理论,我是从头跟到尾,其中的坑已经全部都踩得差不多了,才敢发表自己的见解。

  1. 好的文章标准
    a. 首先提供了新的认知,创造了价值。比如很多文章给读者普及知识。
    b. 信息量大且密度高,也就是说文章可以长,但信息量要够多。不然就显得啰嗦。
    c. 逻辑和论证精彩。
    d. 容易理解,不能高冷。
    e. 真诚沟通,不装。

感悟: 我有些文章,确实是太长了,因为都是一些知识性的总结,但都很少发表自己的见解以及自己有没有去论证这个知识点。

  1. 要有目的的写作。
    a. 明确写作目的,写出去能得到的收获。明确阅读对象。

感悟:希望自己有一天也能去踏出这一步,去勇敢的写更多的感悟。

  1. 采取双向沟通的写作
    让对方觉得在聊天,而不是只是传授知识。

  2. 从作者逻辑切换到读者逻辑
    a. 从表达逻辑到倾听逻辑。
    b. 从粉丝角度分析

  3. 一个格式化的写作套路?
    (1)我要说的是什么概念?
    (2)这个概念为什么重要?
    (3)这个概念通常被如何误解?
    (4))这个概念实际上是怎么回事儿?
    (5)这个概念有什么意义?
    (6)如何正确使用这个概念?
    (7)错误使用这个概念有什么可怕之处?
    (8)这个概念与哪些其他重要概念有重要的联系?

再高级一点的写作公式比如以下六条。
(1)场景化写作,引出一个痛点话题。
(2)针对痛点话题,提出一个新鲜观点。
(3)正面论证这个观点。小标题+案例。
(4)反面论证这个观点。小标题+案例。
(5)总结这个观点的意义、价值。
(6)给出具体的执行建议,呼吁大家去做。

但是上述都是一种非技术类型的写作。 如果是写技术类的文章, 就需要
先说自己这个文章讲啥
然后讲一下为什么这个技术(对比优劣),
最后将一下怎么做的(给出细节, 按照软件工程的细节最好,图表并茂),
最后总结。

感悟: 这三段论也许自己可以稍微注意一下。

  1. 文章各部分的注意事项。
    a. 题目大众一点,话题聚焦用户关注的点,带来新的知识。
    b. 开头带来价值和重点。
    c. 小标题要总结好。
    d. 文章要多用名词,动词,少用形容词。

技术文章写作技巧

  1. 内容具有普适性,越通俗,越接地气的文章看的人越多。
  2. 分享知识的文章不如讲道理的文章。讲道理的文章不如讲故事的文章。
  3. 目标受众越明确越好。
  4. 文章的几个层次:

文章的灵魂是逻辑
文章的骨骼是结构
文章的案例和陈述是肉
文章的格式和错误是皮

参考

  1. 读书笔记: 技术文章写作指南
  2. 技术文章写作技巧
  3. 程序员该如何写一篇高质量的技术文章

猜你喜欢

转载自blog.csdn.net/qq_43211060/article/details/125126822