What Makes the Intro to Crafting Interpreters so Good?a day agohttps://refactoringenglish.com/blog/crafting-interpreters-intro/《Crafting Interpreters》的引言有效地回答了读者的两个关键问题：相关性和价值。它直接说明了本书的目的：实现解释器并设计值得实现的语言。作者通过指出这本书反映了他十年的思考，并且是为过去的自己而写，建立可信度，吸引了初学者/中级学习者。开篇句子（'我非常兴奋能和你一起踏上这段旅程'）设定了一种朴实、易接近的基调，与像《龙书》这样的学术文本形成对比。引言的成功在于四个要素：说明你将学到什么、为什么它很重要、设定随意的语气，以及在前四句话内实现所有这些。
How to Write an Effective Software Design Documenta day agohttps://refactoringenglish.com/excerpts/write-an-effective-design-doc/设计文档迫使你在实施之前仔细考虑重要决策，从而节省时间并避免代价高昂的错误。它是在团队成员和合作伙伴团队之间协调设计决策的最佳方式，尤其适用于复杂或风险高的项目。当多人协作、项目周期超过三个月、在生产环境中运行多年、涉及跨团队工作、目标不明确或存在灾难性风险时，应编写设计文档。投入的精力应与项目的复杂性成正比；简单的项目可能只需一页纸，而复杂的项目可能需要50页的文档并经过签字批准。只包含那些错误代价高的决策——琐碎的选择（例如分页样式）不属于设计文档的内容。关键组成部分：标题、元数据、目标、背景、相关文档、目标、非目标、场景、图表、术语表、约束条件、服务等级目标、监控、时间线、接口、依赖关系、安全性、隐私、法律、日志记录、未解决问题、已解决问题和考虑的替代方案。通过向团队分享设计文档并运用技巧来获取有用的反馈，同时避免阻碍进展，从而推动设计文档的评审。
Writinga day agohttps://hey.paris/books-and-events/books/创作小说，包括短篇作品如《椅子》和《信噪比》。在15年间为Wiley和O'Reilly Media撰写了多本技术书籍，目前正在休息中。知名著作包括《Unity开发食谱》、《机器学习实用模拟》和《深入浅出Swift》。参与政策提案，倡导在澳大利亚将电子游戏视为文化的一部分。发表关于游戏开发马拉松、移动技术和个人信息管理的学术论文。
LLMs for technical editing: The good, the bad, and the ugly20 days agohttps://techstackups.com/articles/llms-for-technical-editing-the-good-the-bad-an...若品牌关联与内容品质至关重要，人工智能完全取代人类编辑的效率较低。克劳德在识别结构、逻辑和一致性错误方面表现良好，但在错别字和语法方面表现欠佳。人工智能编辑存在丧失作者声音、意图和风格的风险，可能导致内容趋同化。两种模型均提出了相互矛盾的建议，并虚构或误判了错误，需由人类进行裁决。建议采用混合方法：人工智能负责初步筛选、逻辑检查和一致性校验；人类负责逐行编辑、重写和最终校对。