- 💂 个人网站:【海拥】【摸鱼游戏】【神级源码资源网】
- 🤟 前端学习课程:👉【28个案例趣学前端】【400个JS面试题】
- 💅 想寻找共同学习交流、摸鱼划水的小伙伴,请点击【摸鱼学习交流群】
2020 年,我加入了技术写作,在CSDN这里我撰写了近 500 篇技术文章,并在网上赚了一些零花钱。根据我的经验写一篇好的技术文章是将复杂的概念分解成简单易懂的语言的文章。
作为技术作者,要将复杂的概念分解为简单易懂的语言,你需要:
首先,了解你正在写的主题。
其次,了解你的写作对象。
然后,了解如何构建文章以将您的信息传递给读者。
最后,知道如何在写作中使用正确的语气。
以下是我将介绍的技术写作过程中的步骤:
目录
- 第 1 步:研究
- 第 2 步:准备写作
- 第 3 步:撰写初稿
- 第 4 步:初稿审查
- 第 5 步:编辑和修改
- 第 6 步:最终稿的校对和批准
- 第 7 步:发布完成的文章
- 结论
- ⭐️ 好书推荐
第 1 步:研究
首先,对你正在撰写的主题进行搜索,并查看与该主题相关的文章。在查看文章时,做笔记以更好地理解主题。
此外,你可以向 ChatGPT 询问有关该主题的信息。然后将你从 ChatGPT 获得的信息与你从 Google 搜索获得的信息进行比较。
其次,确定您要撰写的主题的格式和结构。
文章结构的类型
技术博客写作中有两种类型的技术文章。
- 程序性文章:这些文章引导读者逐步完成任务。
- 概念文章:这些文章帮助读者深入理解主题,为进一步学习打下基础。
第三,确定您将要撰写的主题的目标受众。
确定目标受众的最简单方法是确定您的受众需要学习什么。
在您将要撰写的技术文章中写下您的目标受众需要学习的所有内容的列表。
第 2 步:准备写作
首先,确定您将要撰写的文章的目的或目标。
在第一步中确定您的受众将帮助您确定文章的目标。
文章的目标可以是帮助读者学习一些东西或解决一个问题。
其次,创建文章大纲。
简而言之,大纲是一篇完成的文章的骨架,它映射了您将在文章中涵盖的主题。
大纲提供了一个结构,可确保您的想法逻辑清晰。
在第一步中确定文章格式和结构将帮助您创建文章大纲。
注意:确定文章目标并创建大纲后,如果是用户的工作,您可以将文章发送给用户以获得反馈,以确保您在同一页面上。
第 3 步:撰写初稿
首先,在标题中包含文章的目标。以下是如何格式化标签,
标题格式
如何使用<软件或技术>
例子
如何使用 JavaScript 创建计算器
其次,开始写文章介绍。每篇文章的引言应有1至3段。
一个好的介绍应该回答的问题
- 解决的问题是什么?
- 这个问题的解决方案是什么?
- 读者会学到什么?
第三,写前提条件。先决条件的目的是准确说明 读者在学习当前教程之前应该具备或做的事情。
该格式是一个列表,读者可以将其用作清单。每个点都必须链接到涵盖必要内容的现有教程或官方软件文档。
这使您可以依赖已知有效的现有内容,而不是从头开始。
第四,逐步开始撰写文章正文。这些步骤是文章的一部分,您在其中描述读者需要做什么以及为什么。
一个步骤包含命令、代码清单和文件,这些文件解释了 要做什么 以及 为什么要这样做。
最后,写下文章的结论。文章的结论应该总结读者通过遵循您的教程所学到的或完成的内容。
第 4 步:初稿审查
写完初稿后,将其发送给用户、主题专家或对你所写主题非常了解的人进行审阅。
由用户或主题专家审阅草稿可确保文章在技术上准确并符合文章的目标。
第 5 步:编辑和修改
编辑和修改是将审阅过的草稿塑造成最终草稿的地方。确保在写作和编辑之间休息一下。休息一下将使您能够以全新的眼光看待您的工作。
您可以在编辑过程中使用一些工具来检查拼写、语法、样式和标点符号错误。
第 6 步:最终稿的校对和批准
校对你的最终草稿是在你完成写作但尚未准备好发布或将其交给用户时进行的。
在这里你通过你的文章来校对:
- 任何拼写错误
- 语法错误
- 错别字
- 格式错误
- 结构或语法不正确
校对终稿后,发给用户最后审阅和批准。
第 7 步:发布完成的文章
如果对最终草案不再做任何更改,用户将发布文章。如果是个人文章,您可以将其发布在你的博客或免费的开发者博客平台上,例如:
- CSDN
- 掘金
- 知乎
- 牛客
- 华为云开发者
- 阿里云开发者
- 腾讯云开发者
- InfoQ
- 51CTO
- 思否
- 博客园
- 开源中国
- 公众号
- 个人网站
- 等等…
结论
在本文中,你已经学会了如何一步一步地写出一篇好的技术文章。如果您喜欢这篇文章,给个点赞与关注吧。
⭐️ 好书推荐
《RHCSA/RHCE8红帽Linux认证学习教程》
【内容简介】
本书从零基础开始讲解,系统介绍了RHCE8的相关知识,以帮助读者快速了解及熟练掌握RHCE8的相关操作,是一本高品质的RHCE认证的学习书籍。本书分为9篇,共35章。第1篇主要介绍基本配置;第2篇主要介绍用户及权限管理;第3篇主要介绍网络相关配置;第4篇主要介绍存储管理;第5篇主要介绍系统管理;第6篇主要介绍软件管理;第7篇主要介绍安全管理;第8篇主要介绍容器管理;第9篇主要介绍自动化管理工具ansible的使用。
📚 京东自营购买链接:《RHCSA/RHCE8红帽Linux认证学习教程》