refactoringenglish-com

这个练习测试你在软件开发语境中识别被动语态的能力。你需要判断每个句子是否包含被动语态，并选择"主动⚡"或"被动😴"来回答。

这是针对Tyler Cipriani关于Git大文件未来文章的初稿编辑笔记。通过明确目标读者、聚焦实用内容、优化结构，最终文章在Hacker News、Lobsters和Reddit的Git版块均登上榜首，获得热烈反响。

本文提供了17条编写高质量软件教程的实用规则，包括为初学者写作、在标题中明确承诺结果、展示最终成果、确保代码片段可复制粘贴等关键建议，帮助作者在众多平庸指南中脱颖而出。

文章探讨了被动语态在技术写作中的争议，指出虽然高中英语老师曾警告被动语态的危险性，但如今软件开发人员应避免使用被动语态，转而采用更直接的主动语态表达。

这个练习测试你在软件开发语境中识别被动语态的能力。你需要判断每个句子是否包含被动语态，并选择"主动"或"被动"选项来检验你的语法识别技能。

有效的提交信息能简化代码审查过程并帮助长期代码维护。本文基于作者20年软件开发经验，分享了编写有用提交信息的实用建议，包括信息组织结构和应包含的关键内容。

本文介绍了"HN人气竞赛"项目的评选方法，包括个人博客的定义标准、评分聚合规则以及数据更新频率。该项目统计Hacker News上获得至少20分的个人博客链接，并汇总各域名至少500分的总得分。

本文探讨了开发者博客无人问津的常见原因，指出即使有深刻见解，若在呈现方式上犯下基础错误也会赶走读者。这些错误通常易于纠正，但许多博主却长期忽视。

软件发布公告应聚焦用户体验的改善，而非简单罗列功能更新。优秀的公告能让用户直观感受到产品如何变得更好用，而不仅仅是技术变更的清单。

对于软件开发人员而言，撰写高效邮件具有巨大价值。好的邮件能节省时间、减少误解，并帮助你在公司内获得认可。

作者在《重构英语：软件开发者高效写作》一书中，通过增量发布方式获得读者实时反馈。在完成约50%内容后，作者希望确保剩余章节能真正满足读者学习需求。

开发者兼播客主持人Adam Gordon Bell分享了他通过博客写作成功吸引客户的经验，包括如何让文章登上Hacker News首页、发现吸引潜在客户的主题、提升写作技巧以及尊重竞争对手的价值。

作者回顾了20年编程生涯中阅读过的数千篇软件文章，从中精选出真正改变其思维方式的核心篇章，包括Joel Spolsky的《乔尔测试》、Alexis King的《解析而非验证》等十篇影响深远的经典作品。

本文分享了如何从团队成员那里获得关于软件设计文档的有用反馈，避免设计评审拖延数月。作者基于多年作为文档作者和评审者的经验，总结出帮助评审过程顺利进行并实质性改进设计的技巧。

《Crafting Interpreters》是一本教授如何从零开始构建编程语言的优秀书籍，其引言部分尤为出色。作者分析了该引言之所以引人入胜的原因，指出开发者通常不擅长写引言，因此值得深入研究其成功之处。

本文分析了2025年Hacker News上最受欢迎的个人博客作者，通过统计个人博客在平台上的表现来识别年度热门博主，不包括公司或团队博客内容。

作为一名拥有20年经验的开发者，作者始终重视清晰写作的重要性。他通过更新团队文档和鼓励同事记录所学，强调写作这一"软技能"对技术工作者的价值，反驳了"写作只是技术作家和产品经理职责"的观点。

作者为同一个开源Web应用创建了三份设计文档：一份耗时16小时手工编写，一份使用Claude Opus 4.6生成，一份使用GPT-5.4生成。AI版本仅需几分钟即可完成，但都基于相同的设计文档结构和书籍章节作为提示。