技术写作中最重要的过度词如下: however therefore for example 在下面的段落中,请注意过渡如何连接句子并使其上下文相关: Juan is a wonderful coder. 单词 定义新术语或不熟悉的术语 在写作或编辑时,识别那些目标受众可能不熟悉的术语。当你您发现此类术语时,请采取以下两种策略之一: 如果该术语已经存在,请链接到现有的具体解释。 是的,技术写作是残酷和充满限制的,但是至少技术写作提供了一个很好的解决方法。即,当引入冗长的概念名称或产品名称时,你您也可以指定该名称的缩写形式。然后,你您可以在整个文档中使用该简称。 主动语态与被动语态 技术写作中的绝大多数句子都应该是主动语态。本单元教你您如何执行以下操作: 区分被动语态和主动语态。 将被动语态转换为主动语态,因为主动语态通常更清晰。 技术文档中的好句子可以确定谁对谁做事。
Brian Roark 等人在2025年出版的新书《书吏的工具:书写系统、技术与人类因素如何共同影响写作行为》对此展开了一场跨学科探索。 从被动工具到“主动写作机器” 纵观历史,书写技术不断变化,但在20世纪之前始终是“被动”的。无论是刻刀、毛笔、活字印刷还是打字机,写作者始终完全掌控文字的生成。 而计算机时代则彻底不同。 技术不该取代书写,而应赋能人类 作者最终强调:与其试图用AI取代书写这种文明最早的技术之一,不如探索如何将AI作为辅助力量,帮助人类更好地使用书写。 被忽视的奇迹:人类大脑如何写作 书评者认为,AI写作的“奇迹感”容易掩盖另一个更伟大的奇迹——人类大脑本身的书写能力。相比阅读的神经机制,写作的大脑过程研究仍十分有限。 也许,人类写作的本质正是一种“看不见的思维活动”在符号世界的投射。 写在最后 从甲骨文到AI写作助手,人类书写从未停止演变。技术让表达更高效,却也在重塑思维方式、学习方式,甚至作者身份本身。
分享人数最多的前6名: 钱行慕、术子米德、metoto、焦杰、Jeanvi Xue、🇹 🇾 🇳 🇦 🇲 分享前50名: 🎼但宁🎵🎶🖤、kan、梁凌锐、Jeanvi Xue、平心静气、看不清回忆、谢顿、zerostyle、胡尧YaoHu(休假中)、时间的朋友、阿锐、老K、Clark、gaomg、惺忪、龙藏浦秦淮河、焦杰、司鑫、vvi、小哈-董超、Lucas Yu、Fafa、Colouful、术子米德、🌀zhz、XTao、Nikki、石来运转、君子如兰、徐毅、Kiki、阿蔡、卢鸣峰、王丽、我是谁、LINKH
Brian Roark 等人在2025年出版的新书《书吏的工具:书写系统、技术与人类因素如何共同影响写作行为》对此展开了一场跨学科探索。 从被动工具到“主动写作机器” 纵观历史,书写技术不断变化,但在20世纪之前始终是“被动”的。无论是刻刀、毛笔、活字印刷还是打字机,写作者始终完全掌控文字的生成。 而计算机时代则彻底不同。 技术不该取代书写,而应赋能人类 作者最终强调:与其试图用AI取代书写这种文明最早的技术之一,不如探索如何将AI作为辅助力量,帮助人类更好地使用书写。 被忽视的奇迹:人类大脑如何写作 书评者认为,AI写作的“奇迹感”容易掩盖另一个更伟大的奇迹——人类大脑本身的书写能力。相比阅读的神经机制,写作的大脑过程研究仍十分有限。 也许,人类写作的本质正是一种“看不见的思维活动”在符号世界的投射。 写在最后 从甲骨文到AI写作助手,人类书写从未停止演变。技术让表达更高效,却也在重塑思维方式、学习方式,甚至作者身份本身。
之后再进行补充 操作系统 Linux常用命令 其他目录需阅读《鸟哥的Linux私房菜》之后再进行完善 数据结构和算法 详细目录需精读《算法》和《算法导论》之后在进行补充 安全攻防 详细目录需详细阅读《黑客攻防技术宝典 写作计划 顺序如下: 基础 -> JVM -> 分布式架构 -> 扩展 -> 设计模式 -> 操作系统 -> 数据结构和算法 -> 安全攻防。
英语世界里,文档非常受重视,许多公司和组织都有自己的文档规范,清楚地规定写作要求,比如微软、MailChimp、Apple、Yahoo、docker、Struts 等等(维基百科有一份完整的清单)。 我就动手,参考上面的规范,也结合自己的实践,总结了一份简单的《中文技术文档的写作规范》。 下面是关于写作风格的一个片段。欢迎提交 Issue 和 PR 补充。 ================================= 写作风格 (摘自《中文技术文档的写作规范》) 如果使用了被动语态,应考虑更改为主动语态。
有群友问过,是什么原因使我开始写技术公众号,又是什么动力让我坚持写的。 在我看来,写作是一件不能敷衍的事,通过写作来学习,反而要比单纯地学习的效果要好。 通过写作,我有了跟其它学习者对话的机会。 看书学习可能只是个人的事情,但是,在写作平台上发布文章,这就超越了个人行为——你得随时准备着被批评、或者被请教、或者被误解、甚至是被无视(这是最常见的结果)。 我享受写作文章,来跟其他处在相同处境的同学们交流,来向更优秀的大牛们学习取经。 这就是我目前写技术文章的一些个人体会吧。 对于上面提到的第二个原因,我最近颇有感触,想要多聊一些。 为了更有针对性,本文姑且限定一个话题吧,那就是“写作技术文章,如何看待他人的批评/意见”。 1、主观性的意见 有些声音其实只是主观看法,我认为可以和而不同。
技术写作的最佳实践 作为一名技术写作者,遵守既定的最佳实践有助于确保您的工作的一致性、清晰性和整体质量。一些常见的最佳实践包括: 始终考虑受众: 牢记用户视角编写内容。 遵循这些最佳实践可以提高您的技术写作效率,并确保您的受众能够轻松理解和保留信息。 讲故事 讲故事是技术写作者的强大工具。它允许您以更相关和更易理解的方式传达复杂的概念和信息。 写作风格指南 作为技术作者,创建写作指南对于确保您创建的所有文档的一致性和质量至关重要。写作指南可以包含有关文本中的风格、语气、术语、句法、标点符号和词汇的一组规则。 这应该有助于保持您写作的统一性,这在处理技术信息时至关重要。您的写作指南将取决于项目要求和目标受众的偏好,它需要任何参与项目的人员都能轻松理解和遵循。 重要的是,随着您在技术写作方面获得更多知识和技能,请务必更新您的指南。
NLG赋予计算机生成高质量人类语言文本的能力,广泛应用于报告生成、智能客服、写作助手等领域。本文将深入探讨自然语言生成技术,并展示如何构建一个简单的AI写作助手。 二、AI写作助手的功能设计AI写作助手通过利用NLG技术,可以实现以下功能:智能提示: 根据上下文自动补全文字。风格调整: 生成不同风格或语调的文本。文法优化: 自动修正语法错误或句式问题。 # 解码生成的文本 return tokenizer.decode(outputs[0], skip_special_tokens=True)# 示例使用prompt = "如何使用自然语言生成技术优化写作效率 运行效果:输入提示为:“如何使用自然语言生成技术优化写作效率?”模型输出:“自然语言生成技术可以通过智能提示和文本扩展功能大幅提高写作效率。 结语AI写作助手的崛起标志着写作从“纯手工”迈向“智能化辅助”的时代。通过自然语言生成技术,我们不仅能提升写作效率,还能激发更多的创意火花。然而,AI写作只是工具,最终的表达仍需人的思考和打磨。
优秀的技术社区每天都会生产出不少干货内容,《XX 框架源码分析》就是其中的一类。然而,这类文章往往叫好不叫座,人气常常不如《手把手教你 XX》。真的是我们太浮躁了吗? 从大学教材到技术写作 中国的大学课堂以照本宣科而著称,而各个学校自己编写的大学教材也是出了名的枯燥无味。那么,一本烂教材一般满足什么条件呢? 这就是差别所在:许多【技术干货】和中国的大学教材一样,并没有把将知识传达给读者作为第一诉求,而是花大量篇幅贴出代码,告诉你【这个很复杂,我读懂了!】。 所以,许多让人感觉晦涩的技术文章,其问题可能并非出在所介绍的技术内容本身,而是出在更基本的行文思路上。 除了上面提及的源码解析类文章,类似的技术内容还包括: 写给自己看的 Debug 笔记,里头都是各种业务细节的流水账。 介绍某个技术点的技术分享 PPT,上来就讲一堆高级特性,生怕别人觉得深度不够。
在这篇文章中,我想概述一下这两个看似截然不同的领域--编程和写作--如何能够结合起来,将我们的开发技能提升到一个新的水平。 等等,技术写作?是的你没看错。我真的相信我们在某种意义上都是作家。 我会在这里给你介绍写作技巧、建议以及例子,使你成为更好的开发者和沟通者。 本文包括以下部分: 技术写作无处不在 什么才是好语法? 技术写作在这方面也起着重要作用。所以没错,我可以非常公正地说,技术写作确实无处不在。 什么才是好语法? 有这么多的编程语言,我们最不想做的就是学习另一种语言。 编写无障碍标记 我们可以轻松地撰写一篇关于无障碍性,以及与技术写作相关的文章。事实上,无障碍性通常包含在内容样式指南中,包括微软[6]和Mailchimp[7]的指南。 因此,如果你发现自己正在将他人的文案编写到代码中,为其他开发者编写文档,甚至自己编写UI文案,要注意一些基本的无障碍最佳实践,因为它们完善了所有其他技术写作的建议。
前言 之前参加了由掘金社区组织的创作者训练营第二期活动,有幸见到了比如月影、工业聚、张晋涛等许多这个行业的大佬,也认识了许多技术写作的博主,可谓是一场大型网友面基会,哈哈哈 . 编辑器 主要针对的是使用 Markdown 语法的编辑器,如果你对 Markdown 语法还不太熟悉,可以先看看我的另一篇文章:十分钟入门 Markdown 写作。 支持如下特性: 实时预览(所见即所得)和简洁明了的界面,使您获得无干扰的写作体验。 支持 CommonMark 规范和 GitHub Flavored Markdown 规范。 支持段落和内联样式快捷方式,以提高您的写作效率。 导出 HTML 和 PDF 文件。 各种主题:Cadmium Light、Material Dark 等等。 通过它,我们可以将我们本地写好的文章分发到国内技术主流平台。此外,软件还支持多个图床,无论你是使用免费的图床还是自己搭建的图床,相信该软件总有适合你的一个图床吧。
昨天参加了由掘金社区组织的创作者训练营第二期活动,有幸见到了比如月影、工业聚、张晋涛等许多这个行业的大佬,也认识了许多技术写作的博主,可谓是一场大型网友面基会,哈哈哈 ?. 编辑器 主要针对的是使用 Markdown 语法的编辑器,如果你对 Markdown 语法还不太熟悉,可以先看看我的另一篇文章:十分钟入门 Markdown 写作。 支持如下特性: 实时预览(所见即所得)和简洁明了的界面,使您获得无干扰的写作体验。 支持 CommonMark 规范和 GitHub Flavored Markdown 规范。 支持段落和内联样式快捷方式,以提高您的写作效率。 导出 HTML 和 PDF 文件。 各种主题:Cadmium Light、Material Dark 等等。 通过它,我们可以将我们本地写好的文章分发到国内技术主流平台。此外,软件还支持多个图床,无论你是使用免费的图床还是自己搭建的图床,相信该软件总有适合你的一个图床吧。
2019.05 我创建了自己的公众号 “理想二旬不止” 和几个技术社区的账号 “BWH_Steven”,自己的分享,偶尔能被认可,满足之感油然而生,从此刻,我也开启了自己真正意义上的技术写作。 最近时不时就会有一丝恍惚,想问自己,技术写作的初心是什么?或许是为了记录,代表自己曾经来过,或许是为了积累和分享,给自己带来成就感,也或许它早已成为了一种习惯。 我心中的技术写作 3.1 如何撰写优秀文章 我认为,优质文章(100%) = 技术(70%) + 文笔(20%)+ 美化(10%)。 接着,我考虑精简输出的平台,只保留个别,同时尽可能的简化非写作本身的繁琐步骤,回归写作本身。 总之,最大的改变就是舍弃了过去本地笔记的写法,对比了多家平台,选择了语雀作为主力写作平台,或许阅读和访问的流量就没有以前那么高了,但是能够投入更多的时间和精力到写作本身,利大于弊。
2020 年,我加入了技术写作,在CSDN这里我撰写了近 500 篇技术文章,并在网上赚了一些零花钱。根据我的经验写一篇好的技术文章是将复杂的概念分解成简单易懂的语言的文章。 作为技术作者,要将复杂的概念分解为简单易懂的语言,你需要: 首先,了解你正在写的主题。 其次,了解你的写作对象。 然后,了解如何构建文章以将您的信息传递给读者。 以下是我将介绍的技术写作过程中的步骤: 目录 第 1 步:研究 第 2 步:准备写作 第 3 步:撰写初稿 第 4 步:初稿审查 第 5 步:编辑和修改 第 6 步:最终稿的校对和批准 第 7 步:发布完成的文章 文章结构的类型 技术博客写作中有两种类型的技术文章。 程序性文章:这些文章引导读者逐步完成任务。 概念文章:这些文章帮助读者深入理解主题,为进一步学习打下基础。 由用户或主题专家审阅草稿可确保文章在技术上准确并符合文章的目标。 第 5 步:编辑和修改 编辑和修改是将审阅过的草稿塑造成最终草稿的地方。确保在写作和编辑之间休息一下。
技术写作者所需的技能 成为一名优秀的技术写作者需要以下核心技能: 写作技巧: 优秀的语言和语法掌握能力 出色的拼写能力 对标点符号的理解 技术知识: 对复杂技术概念有很好的理解 将复杂概念转换为易于理解的内容 等 了解布局和设计的知识是技术写作者的一大优势 注重细节: 具有细节导向,以创建干净、高质量的内容 组织能力: 能够管理多个项目并始终如期完成任务 科技知识: 技术知识主要指技术写作者对他们所写技术或主题的理解 这种能力使技术写作者能够创建全面、准确、用户友好的文档和手册。 语言能力: 技术写作领域广泛需要“语言能力”。这项技能包括对技术文档所用语言的出色掌握。 总体而言,技术写作需要广泛的技能组合,包括写作技巧、技术知识、研究技巧、工具技能、设计技巧、注重细节、组织能力、科技知识、语言能力和书面沟通技巧。 具备这些技能的技术写作者可以创建准确、清晰、易于理解的技术文档,帮助读者理解复杂的技术概念并完成任务。
目录前言简洁性与专注度版本控制与协作跨平台兼容性 转换和发布社区和工具支持实际使用案例性能和资源消耗可访问性和无障碍性结束语前言在技术写作的时候,选择合适的工具对于提高写作效率和保证文章质量至关重要,作为一名前端开发者和技术文章创作者 个人觉得,技术文章的写作不仅仅是关于内容的传达,还包括格式的整洁、信息的准确和阅读的便捷性。 2、Word的工具生态虽然Word也有广泛的工具和插件支持,但在技术写作和技术社区中,word有很大的格式局限性,而Markdown通常更受大家青睐。 还是那句话,选择哪种工具最终取决于个人偏好和具体对写作需求,但对我来说Markdown提供了一个更加专注于内容、高效且灵活的写作环境,这也正是我在技术写作中比较看重的地方。 最后,我希望通过我的个人经验,能够为其他技术写作者在选择写作工具时提供一些参考价值,以上观点仅为个人观点,如有不妥之处还请各位看官指正。
技术写作简介 技术写作是指用简单易懂的语言向特定受众解释复杂概念的一种写作形式。这种写作形式通常用于工程、计算机硬件和软件、金融、消费电子和生物技术等领域。 清晰度: 技术写作应该易于理解,即使是对于没有技术背景的读者。技术作者需要避免使用术语和行话,并用清晰简洁的语言解释复杂的概念。 简洁: 技术写作应该尽可能简洁。 目标导向: 技术写作应该针对特定的受众和目标。技术作者需要考虑读者的知识水平和需求,并根据此信息来编写内容。 技术写作在许多行业中都发挥着重要作用。 技术写作者的最终目标是使最终用户,无论是客户、员工还是任何利益相关者,都能够毫不费力地理解和使用产品或服务。 技术写作是什么? 技术写作涉及使用简单易懂的语言向特定受众解释复杂概念。 技术写作者必须了解这些形式之间的区别和适当用法,才能有效地传达技术信息。 技术写作者的成长 技术写作领域的成长阶段令人着迷。随着技术写作者获得经验并持续表现出色的工作,他们很可能会遇到许多成长的机会。
一 报告导读 本次报告主要介绍智能写作前沿技术和应用,从内容创作、智能辅助写作助手、机器翻译等方面展开,介绍了智能写作在写稿机器人、赛事解说、智能广告文案、社会公益、经济扶贫等具体场景中的应用案例,对智能写作目前研究上的主要进展和面临的挑战进行了总结概括 三 报告内容 为什么做智能写作呢?先看看每个人每天花多少时间在写文字上。比如写一篇文章、写Email。 曾经有个笑话说,一个博士生、研究生回老板的eMail,平均每封要花一天半的时间,花很长时间构思,所以写作非常重要。写作当中的核心算法问题是什么呢? 另外一点,它需要满足一定的条件,比如要表达一定的意思或者某些关键词必须出现在里面,或者某些知识点必须出现在里面,我后面会介绍如何用技术实现这两点。 ? 我们看一下写作技术为什么重要? 第二点是智能辅助写作助手,它可以帮助人去写作,你写前两个字,会把后面一句话补全。另外还有机器翻译,因为它们跟写作技术用的是同一个技术。机器翻译在跨语言的文化交流里面,是非常重要的技术。
03、写好文档 3.1 文档模板 文档的内容、结构决定了文档的质量,如无特殊说明,技术文档应该采用固定的模板编写。 当前我们团队已有的技术文档模板包括: 【模板】后台串讲文档模板 【模板】后台性能评测文档模板 【模板】后台架构评审文档模板 【模板】技术产品 Case 调查总结文档模板 【模板】Case Study 模板 3.4 技术评审文档建议 技术评审文档是我们日常写得较多的文档,下面举两个例子。 一种是必须及时更新的,譬如:技术产品对外的接口文档,需要结合迭代进度在每次技术升级时例行更新。另一种是读者不多,更新滞后影响较小的,譬如:给团队新人阅读的新人手册,可以在有新人入职时再更新。 05、推荐阅读书籍 《金字塔原理》 《一本小小的红色写作书》