怎么在头条成为技术型作者?

2024-05-05 12:19

1. 怎么在头条成为技术型作者?

曾经说过我的许多榜样中的一位,她开始进入技术写作的原因是为了让她在作为软件开发人员的不断发展的旅程中记下新的学习和发现,帮助她在“重新面对同样的问题/错误时不会迷路“。
一种深入的教学,解释或分解逻辑的方式与其他方式一样,是通过写作,因为它可以让您根据自己的方便探索所有创造性思维,而不必担心怯场。
技术写作涵盖所有这些和更多,它涉及将复杂的技术过程或意识形态记录为简单易懂的格式。它从用户或技术产品或服务的使用说明手册开始,并从此开始着手编写技术或专业主题,例如计算机应用程序和工具,软件开发语言和框架,医疗程序,环境法规等
技能:
技术写作技巧对一些人和其他人来说是自然而然地学到的,但总的来说,成为一名优秀技术作家所需的一些关键技能包括:
*强大的写作和沟通技巧*:将复杂的意义和术语以更简单和易理解的语言向观众转达的能力是必须具备的,因为它们降低了阅读文章的本质,即了解他们的内容一直没有。
*与该领域相关的技术经验/技能*:传达讯息意味着理解和掌握它,在您写的内容领域的知识和经验是一项要求。假设你目前在指定的领域工作或有知识,因此知道你的洋葱,很多技术作家在他们的领域担任技术职位,例如软件开发人员/工程师,信息安全分析师等。在一个你熟悉的领域写作在制作一篇伟大的文章方面有很长的路要走。
*兴趣*:对科技拥有(巨大的)兴趣使您在攻读技术写作时有一定的优势,因为它刺激了技术写作,并让您随时了解新技术的学习和写作。
*研究技巧*:写作涉及(很多)收集和比较来自不同来源的数据和发现以及您对该主题的个人知识,从而变成有价值的书面信息。
流程:
写一篇技术文章可能与通常的文章有很大不同,可能需要相当长的一段时间,因为大多数时候都需要重新创建简单到复杂的实际技术步骤,以便传达您的目标。由于这些原因,在写作之前和写作时,总是会采取以下精确步骤,以免在您的文章中造成严重缺陷:
了解你的读者:读者始终站在技术作家头脑的最前沿,了解你正在写作的读者类别可以简化剩下的任务。在使用不熟悉的技术或先进的说法的同时,写一篇适合初学者使用的假文章将无法消除这些信息。您的受众定义了使用的文本以及您的信息如何传达。为了更好地了解您的听众,在开始撰写文章之前,应该考虑以下问题:
他们是谁?
他们需要什么(从你的文章中学习)?
他们将在哪里阅读你的文章?
他们为什么要阅读?
他们将如何阅读?
这些问题在帮助理解你的听众方面有很长的路要走。
绘制您的文章:撰写技术文章看起来像是一项复杂的艰巨任务,并且从哪里开始,但是您的观众清晰定义,创建地图或指南(开始完成)变得容易得多。概述你的听众应该从阅读中获得的必要信息,并可能将其转化为观点/指导方针,一些作者喜欢概括所有这些内容,即在文章的开头部分创建一个概述,以便读者了解他们期望什么继续。在您的文章中进行强有力的介绍也有助于您了解接下来的文章。创建地图或指南有助于突出显示您可能没有想过甚至不知道的其他领域,并有助于让您更熟悉和准备。
反馈迭代:没有作家是知识的高峰,就像技术职业专业人员对评论和反馈的鼓励一样,技术写作也是如此。从同事,专业人员,现场专家等角度对您的文章进行技术审查和反馈,并以观众的思维观点阅读您自己的文章,这有助于发现可能在发表文章之前逃脱审查的语法和技术错误。
*内容创意*:现在您已经了解了您的读者并掌握了您的文章的地图或指南,通过保持文章的风格注入创意,同时在文章的主体中清晰地传达您的讯息,可以让您的读者注意到很长的路要走最终。这里有一些例子:
词的选择:选择你的文字并在必要时加入更多的细节可以帮助你的文章更易于理解。
示例:打开命令行并在“文档”目录内执行XYZ操作
改进:打开命令行,通过输入“ cd documents”并执行XYZ操作进入“文档”目录。
持续使用主动语态:在文本中使用主动语音比被动语音更容易阅读和理解。
示例: Node.js npm包注册表中包含超过350,000个包
改进: Node.js npm包注册表包含超过350,000个包。
句子结构:将重要的信息放在第一句话中有很长的路要走。
示例:在执行数据库更新之前,始终建议备份数据。如果你不坚持这一点,永久性数据丢失的可能性很大
改进:建议在执行数据库更新前备份数据以避免数据永久丢失。
避免使用技术俚语/缩略语/行话:很容易陷入写文章和产生所有这些信息,我们无意中使用了我们自己和朋友或同事朋友熟悉的缩写/俚语/动词。在撰写文章并打算使用不熟悉的术语时,最好将它们全部陈述出来,定义它们,然后用缩写引用它,而不是直接向前跳,同时让观众在黑暗中。
例如:该 MVC 模式是跨各种框架广泛接受。
改进: 模型- 视图- 控制器(MVC)模式在各种框架中被广泛接受。
启动基于任务的方法:大多数技术文章以读者的教程或DIY形式出现,因此,以步骤形式编写文章也是使文章更全面的好方法。确保遵循正确的步骤顺序,让你的写作自然流畅。
好处:
作为技术作家有很多好处,其中一些包括:
不断学习,不断努力跟上新技术的发展,提高你的阅读和写作技巧,潜入新的领域并不断得到反馈。这是一个向上的增长规模。
这是一项珍贵且有利可图的技能,因为任何擅长以简单的术语将用户的技术复杂性传达给用户的人都被称为“有价值”的组织,他们总是愿意为此付出沉重的代价。一些受欢迎的网站申请付费技术写作演出是Pusher,Scotch.io,logrocket等
这对于技术人员来说是一种职业提升和附加技能,因为他们被视为能够快速掌握,分解和转发技术使用和对用户的重要性。

怎么在头条成为技术型作者?