程序员需要的结构化文章——追求精简,学会做减法

    如今在网络上有很多低质量的技术文章,这些文章在视觉和逻辑上都十分混乱,读者很难从中获得有价值的内容。
    从个人感受出发,想谈一下我的想法。

技术文章普遍存在的问题
  • 填充大段代码
    有时只需要几行代码就可以说明白的问题,总要贴上整块代码,更有甚者,代码结构毫无缩进与格式,我相信大部分人没有耐心去看这些“脏”代码。
  • 文章内容安排头清脚重
    把关键内容放在最后展示,前面则无穷无尽地展示一些过于庞杂的内容。
  • 文章内容缺少结构化组织
    没有合理的内容组织形态,一味地流水账一样平铺直叙,毫无新意。
  • 频繁引流
    文章中只有一个链接,为的是引流到其他博客网站上的内容(有可能还不是自己写的),这种现象还是比较普遍的,完全违背了读者浏览一篇文章的初心——用最短的时间获取最有价值的内容。
  • 错误横生
    各种本可以避免的文字错误,语法错误,代码错误却在一些文章中频繁出现。
  • 缺少及时的文章维护、读者沟通
    文章作者经常进行一锤子买卖,忽视评论内容,导致一些文章问题长期存在而得不到解决。
几点希望与建议
  • 进行文章编写时可参考结构化的思想,保持文章内容的简洁高效。
  • 尽量保证文章的观点明确、内容清晰、文字流畅、风格统一。
  • 作者应用心编写文章,尽量保证文章质量,对发现的问题及时修改。
  • 与文章评论者保持良好的沟通,保持活跃的交流氛围。
  • 技术类网站对文章的审核应更加严格,坚决杜绝粗制滥造的文章通过审核。

你可能感兴趣的:(程序员日常)