如何撰写技术文章以提升读者阅读体验?
- 内容介绍
- 文章标签
- 相关推荐
本文共计4740个文字,预计阅读时间需要19分钟。
在上一篇文章中,我简要表达了个人的一些想法。然而,有些观点表述不够清晰,部分细节甚至可能让人产生误解(例如对自信的理解)。因此,我决定重新撰写一篇关于如何撰写技术文章的博文,希望能与大家深入交流。
上一篇文章我尽管表达了自己的一些想法,但却有些观点写得不够清楚,部分细节让人误解(比如对自信的理解)。所以,我决定重新写一篇专门讲如何写技术文章的博文,来与大家交流我的写作体会。本文适合有一定技术积累愿意与他人分享技术心得的读者。由于并未涉及具体技术,愿意写作的读者均可以阅读。
技术文章如何写作能让读者有较好的阅读体验,是一个仁者见仁,智者见智的问题。甚至很多人都认为根本不需要考虑读者的感受,把技术写好写准确就可以了,这其实就是一大误区,你的写作如果只是给自己看,当然我也就不多说什么,但如果你的写作是给别人看,就一定要考虑如何写的问题,因为这是一个信息传递的过程而不是简单的记录。
事实上,对于一个准备开始写作的人来说,通常是会认为自己写的东西一定是对的。如果一定要完全正确才可以写文章的话,那就会让绝大多数人裹足不前。因此,写得对不对虽然是作者应该首先要把握的,但是无论作者自己还是别人都无法在写出文章公布之前知道这一点,因此这不是我本文要谈的重点。
我的核心观点是: 好的技术文章,是让符合阅读条件的读者,在良好阅读体验的情况下,看懂学会甚至掌握文章要传达的信息。因此,需要写作中不断思考,这样写,读者会有什么感受。如果你的写作不能让读者有一种收获的喜悦,或者阅读体验不佳,那么你的写作就是有问题的。问题可能会有很多方面,我们一点点分析。
本文共计4740个文字,预计阅读时间需要19分钟。
在上一篇文章中,我简要表达了个人的一些想法。然而,有些观点表述不够清晰,部分细节甚至可能让人产生误解(例如对自信的理解)。因此,我决定重新撰写一篇关于如何撰写技术文章的博文,希望能与大家深入交流。
上一篇文章我尽管表达了自己的一些想法,但却有些观点写得不够清楚,部分细节让人误解(比如对自信的理解)。所以,我决定重新写一篇专门讲如何写技术文章的博文,来与大家交流我的写作体会。本文适合有一定技术积累愿意与他人分享技术心得的读者。由于并未涉及具体技术,愿意写作的读者均可以阅读。
技术文章如何写作能让读者有较好的阅读体验,是一个仁者见仁,智者见智的问题。甚至很多人都认为根本不需要考虑读者的感受,把技术写好写准确就可以了,这其实就是一大误区,你的写作如果只是给自己看,当然我也就不多说什么,但如果你的写作是给别人看,就一定要考虑如何写的问题,因为这是一个信息传递的过程而不是简单的记录。
事实上,对于一个准备开始写作的人来说,通常是会认为自己写的东西一定是对的。如果一定要完全正确才可以写文章的话,那就会让绝大多数人裹足不前。因此,写得对不对虽然是作者应该首先要把握的,但是无论作者自己还是别人都无法在写出文章公布之前知道这一点,因此这不是我本文要谈的重点。
我的核心观点是: 好的技术文章,是让符合阅读条件的读者,在良好阅读体验的情况下,看懂学会甚至掌握文章要传达的信息。因此,需要写作中不断思考,这样写,读者会有什么感受。如果你的写作不能让读者有一种收获的喜悦,或者阅读体验不佳,那么你的写作就是有问题的。问题可能会有很多方面,我们一点点分析。

