分享

技术写作过程:如何写出好的技术文章

 海拥 2023-02-17 发布于安徽
  • 💂 

2020 年,我加入了技术写作,在CSDN这里我撰写了近 500 篇技术文章,并在网上赚了一些零花钱。根据我的经验写一篇好的技术文章是将复杂的概念分解成简单易懂的语言的文章。

作为技术作者,要将复杂的概念分解为简单易懂的语言,你需要:

首先,了解你正在写的主题。
其次,了解你的写作对象。
然后,了解如何构建文章以将您的信息传递给读者。
最后,知道如何在写作中使用正确的语气。

以下是我将介绍的技术写作过程中的步骤:

目录

第 1 步:研究

首先,对你正在撰写的主题进行搜索,并查看与该主题相关的文章。在查看文章时,做笔记以更好地理解主题。

此外,你可以向 ChatGPT 询问有关该主题的信息。然后将你从 ChatGPT 获得的信息与你从 Google 搜索获得的信息进行比较。

其次,确定您要撰写的主题的格式和结构。

文章结构的类型

技术博客写作中有两种类型的技术文章。

  • 程序性文章:这些文章引导读者逐步完成任务。

  • 概念文章:这些文章帮助读者深入理解主题,为进一步学习打下基础。

第三,确定您将要撰写的主题的目标受众。

确定目标受众的最简单方法是确定您的受众需要学习什么。

在您将要撰写的技术文章中写下您的目标受众需要学习的所有内容的列表。

第 2 步:准备写作

首先,确定您将要撰写的文章的目的或目标。

在第一步中确定您的受众将帮助您确定文章的目标。

文章的目标可以是帮助读者学习一些东西或解决一个问题。

其次,创建文章大纲。

简而言之,大纲是一篇完成的文章的骨架,它映射了您将在文章中涵盖的主题。

大纲提供了一个结构,可确保您的想法逻辑清晰。

在第一步中确定文章格式和结构将帮助您创建文章大纲。

注意:确定文章目标并创建大纲后,如果是用户的工作,您可以将文章发送给用户以获得反馈,以确保您在同一页面上。

第 3 步:撰写初稿

首先,在标题中包含文章的目标。以下是如何格式化标签,

标题格式

如何使用<软件或技术>

例子

如何使用 JavaScript 创建计算器

其次,开始写文章介绍。每篇文章的引言应有1至3段。

一个好的介绍应该回答的问题

  • 解决的问题是什么?

  • 这个问题的解决方案是什么?

  • 读者会学到什么?

第三,写前提条件。先决条件的目的是准确说明 读者在学习当前教程之前应该具备或做的事情。

该格式是一个列表,读者可以将其用作清单。每个点都必须链接到涵盖必要内容的现有教程或官方软件文档。

这使您可以依赖已知有效的现有内容,而不是从头开始。

第四,逐步开始撰写文章正文。这些步骤是文章的一部分,您在其中描述读者需要做什么以及为什么。

一个步骤包含命令、代码清单和文件,这些文件解释了 要做什么 以及 为什么要这样做

最后,写下文章的结论。文章的结论应该总结读者通过遵循您的教程所学到的或完成的内容。

第 4 步:初稿审查

写完初稿后,将其发送给用户、主题专家或对你所写主题非常了解的人进行审阅。

由用户或主题专家审阅草稿可确保文章在技术上准确并符合文章的目标。

第 5 步:编辑和修改

编辑和修改是将审阅过的草稿塑造成最终草稿的地方。确保在写作和编辑之间休息一下。休息一下将使您能够以全新的眼光看待您的工作。

您可以在编辑过程中使用一些工具来检查拼写、语法、样式和标点符号错误。

第 6 步:最终稿的校对和批准

校对你的最终草稿是在你完成写作但尚未准备好发布或将其交给用户时进行的。

在这里你通过你的文章来校对:

  • 任何拼写错误

  • 语法错误

  • 错别字

  • 格式错误

  • 结构或语法不正确

校对终稿后,发给用户最后审阅和批准。

第 7 步:发布完成的文章

如果对最终草案不再做任何更改,用户将发布文章。如果是个人文章,您可以将其发布在你的博客或免费的开发者博客平台上,例如:

  • CSDN

  • 掘金

  • 知乎

  • 牛客

  • 华为云开发者

  • 阿里云开发者

  • 腾讯云开发者

  • InfoQ

  • 51CTO

  • 思否

  • 博客园

  • 开源中国

  • 公众号

  • 个人网站

  • 等等…

结论

在本文中,你已经学会了如何一步一步地写出一篇好的技术文章。如果您喜欢这篇文章,给个点赞与关注吧。

    转藏 分享 献花(0

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多