学习软件工程以来,这是我第一次接触和撰写个人技术博客,一方面是老师的要求,另一方面也是对自我心得的一个总结和整理,在浏览了大量关于新手菜鸟如何写博客的文章后,我大概将撰写博客的一些基本的思路整理归纳了起来,在以后的学习过程中,我相信会有更多的新的见解和看法,会随时进行补充和完善。
1.确定一个清晰明了的标题
文章的内容质量是否高明,很大程度上取决于标题是否足够的吸引人,在拥有阅读量后,就会有量的变化。拥有一个清晰明确的标题,也能让更多人发现你,找到你。
当起了标题以后,应该多查阅其他人的相关文献,不同人对于同一个问题应该是持有不同看法的,所以通过阅读和整理多个人对同一事件的描述可以让自己更深刻,更多角度地理解这个问题,然后再结合自己的理解,就会理解的很快,也比较透彻。
2. 明确目标和受众
确定好标题后就需要确定你的目标读者群体。了解你的读者群体是极其重要的一步,他们是怎么样的人,知识层面是否一致,这些人需要什么思维方式。这是极其重要的一步,最好是能够把你对读者的要求写在文章的前面,这样对你和读者都有好处。了解目标群体就像产品经理了解目标用户需求,切身体会到了才能做出好的产品。
3、不要重复文档,给出链接就好。
个人技术博客的‘重点是写自己的心得,体会和总结。对于那些在官方文档中都讲的很清楚的东西就没有必要再进行重复了,给出相应的链接就好了。
4、必须亲自实践进行验证,确保可靠可行。并附上实例和运行结果等
当我配置环境或者安装eclipse时,我也会想到上网去查阅相关的资料和文献,当看到具有明确的步骤和相对于的截图等时,我便会更加趋向于相信这一篇文章。
5、内容精而深
讲的越详细越好,范围越小越好,但要深入的讲,正如那句话,十个百分之十不如一个百分之百。如果你不能深入的讲,证明你还没有到写的时候,应试再去学习或者实践,直到你能讲的很清楚,讲的很详细,讲的很深入的时候再来总结和写博客。争取做到一篇文章一个点,这样文章多了就成了网最后变成没有漏洞的面。
6、突出主题,分清主次,逻辑清楚,层次分明
这可能是对于写作的通用要求,说起来容易,但是做起来就比较困难。其实也不难,主要表现在:
- 列表来罗列要讲的东西
- 用标题先简明概括,然后再详细讲解
- 标题与正文用不同的字体样式标识
- 用字体和缩进来标识标题和正文
编程技术这就好比写完代码后的调试与测试。好代码是改出来的,好文章也是如此。能够一蹴而就的人有,但很少。
以上内容便是我作为菜鸟的第一次尝试总结,虽然内容简单且幼稚,但这也是作为小白的必经之路,谁不是从hello world学起的呢。以上内容有借鉴相关文献,如有雷同之处请多多海涵~
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步