The Best Software Writing I pdf epub mobi txt 电子书 下载 2026
- 软件开发
- 软件工程
- 杂文
- joel
- 计算机
- software
- programming
- development
- 软件工程
- 编程
- 写作
- 技术书籍
- 代码风格
- 文档编写
- 软件设计
- 开发实践
- 最佳实践
- 程序员
具体描述
Frustrated by the lack of well-written essays on software engineering, Joel Spolsky (of www.joelonsoftware.com fame) has put together a collection of his favorite writings on the topic. With a nod to both the serious and funny sides of technical writing, The Best Software Writing I: Selected and Introduced by Joel Spolsky is an entertaining read and a guide to the technical writing literati. The Best Software Writing I contains writings from: * Ken Arnold * Leon Bambrick * Michel Bean * Rory Blyth * Adam Bosworth * danah boyd * Raymond Chen * Kevin Cheng and Tom Chi * Cory Doctorow * ea_spouse * Bruce Eckel * Paul Ford * Paul Graham * John Gruber * Gregor Hohpe * Ron Jeffries * Eric Johnson * Eric Lippert * Michel Lopp * Larry Osterman * Mary Poppendieck * Rick Schaut * Aaron Swartz * Clay Shirky * Eric Sink * why the lucky stiff
作者简介
Ken Arnold在计算机领域从业10多年，参与开发了伯克利(Berkeley)分校的BSD(Berkeley Software Distribution，加州大学伯克利分校软件)项目，创建了CUl'ses库，改进了rogue；为Unix Review著写“The C Advisor”专栏(此后的“The C++Advisor”令我们受益匪浅)，并与其他作者合著了The Java Programming Language等图书；设计了JavaSpaces并辅助设计了Jini：偶尔他还会写写博客。目前他关注的重点包括编程语言与API中的人为因素、令人信服的电子投票系统以及更能体现出GUI临时性的Java的Napkin插件式外观。
目录信息
读后感
或者你已经知道 Joel Spolsky 是谁，一位有名的开发者，他的 blog 受到不少开发者的欢迎。或许译者认为 Joel 的知名度能为此书赢得更好的销量，所以直接把书名译作“Joel 谈优秀软件开发方法”，与原名“The Best Software Writing I”偏离甚远。或许书名翻译为“优秀软件开发...
评分 评分或者你已经知道 Joel Spolsky 是谁，一位有名的开发者，他的 blog 受到不少开发者的欢迎。或许译者认为 Joel 的知名度能为此书赢得更好的销量，所以直接把书名译作“Joel 谈优秀软件开发方法”，与原名“The Best Software Writing I”偏离甚远。或许书名翻译为“优秀软件开发...
评分我将此书定位为工作之余，闲暇读物，偶有所得即可。 读每篇文章时，我常常想该文大致对哪种读者有益，如果您有兴趣则听我慢慢道来，请往下看。或许这样您可以按您的兴趣选读文章，既不会错过精彩的文章又可以节省您宝贵时间。 -------------------------------------------...
评分我将此书定位为工作之余，闲暇读物，偶有所得即可。 读每篇文章时，我常常想该文大致对哪种读者有益，如果您有兴趣则听我慢慢道来，请往下看。或许这样您可以按您的兴趣选读文章，既不会错过精彩的文章又可以节省您宝贵时间。 -------------------------------------------...
用户评价
翻开这本书，最让我感到意外的是其哲学思辨的深度，这远超出了我对一本技术写作指南的预期。它似乎并非仅仅教你“怎么写”，而是深入探讨了“为什么我们要写”以及“写作在软件生命周期中究竟扮演了何种角色”。其中有一章集中讨论了“知识的熵增”与文档维护的悖论，作者以一种近乎社会学的视角，分析了为什么随着团队规模扩大和项目复杂度的增加，文档总是倾向于腐烂和失真。他们引用了一些早期人机交互的理论，将文档视为人与代码之间、以及人与人之间进行时间旅行式沟通的介质。这种讨论的层次很高，需要读者具备一定的理论背景才能完全消化。我花了很长时间才理解其中关于“意图捕获”的论述——即优秀的文档不仅仅记录了“做了什么”，更重要的是捕捉了“为什么这么做”的初始设计意图。这让我反思了自己过去写文档时那种填鸭式的记录方式。然而，这种高屋建瓴的理论讨论，也导致了阅读体验上的跳跃感。它更像是一系列精彩的散文或学术论文的合集，而非一条清晰、连贯的阅读路径。对于期待直接上手操作指南的读者，可能会感到有些“云里雾里”。
评分我从这本书中获得的最大收获，或许是对“受众导向”这一概念的重新定义。书中用了整整一个部分来区分不同层次的受众——从编译代码的工程师，到进行系统维护的运维人员，再到最终使用产品的终端用户。更细致的是，它甚至探讨了在同一个团队内部，不同职能背景的工程师（例如后端与前端）在阅读同一份设计文档时，他们关注的焦点和理解上的偏差。这种对“阅读心理学”的关注，是我在很多现代技术写作指南中找不到的。书中的案例非常生动，通过对比“糟糕的描述”和“优秀的描述”，直观展示了措辞微小变化如何引发巨大的沟通成本差异。例如，书中对比了使用“必须”和“推荐”这两个词在合规性文档中的法律和实际操作影响。然而，这些案例大多来自于大型企业级软件的背景，它们的文档流程冗长且层级森严，这使得我在尝试将这些经验应用到我们这种小团队、快迭代的互联网产品时，总感觉像是在用卡车去完成自行车能胜任的工作。它为我们树立了一个极高的理想标准，但如何经济高效地达到这个标准，书中提供的路径图并不清晰。
评分这本书的内容编排有一种强烈的“百科全书”式的松散感，虽然声称是“精选”，但每篇文章之间的逻辑过渡并不总是那么自然。我感觉这更像是编辑们将某一个时间段内，圈内最受推崇的一些关于软件描述的文章，不加太多修饰地汇编在一起。例如，一篇关于API文档风格的深入探讨之后，紧接着可能就是一篇关于撰写内部技术规范的冗长模板分析。这两种风格和受众差异巨大。我尤其欣赏其中关于“简化复杂性”的几篇关键论述，它们探讨了如何通过精妙的结构组织和语言选择，将底层复杂的算法逻辑，转化为业务人员可以理解的叙述框架。但这种精妙之处，往往需要读者具备很高的信息筛选能力。我不得不承认，我花了大量的精力去辨别哪些是放之四海而皆准的原则，哪些是特定技术栈或特定历史背景下的产物。这本书的优点在于其广度，涵盖了从用户界面文本到核心设计文档的方方面面，但缺点也在于此——深度上，它显得有些分散，缺少一个能贯穿始终的、统一的现代写作方法论的框架支撑。
评分这部厚重的《The Best Software Writing I》初版我入手有些年头了，坦白说，它更像是一本时代的编年史，而不是一本聚焦于“如何写出最佳软件文档”的实操手册。我最初期望的是，能从中找到一套系统化的、适用于现代敏捷开发环境下的文档撰写流程和最佳实践。然而，当我翻开它时，映入眼帘的更多是上个世纪末期或千禧年初，那种大型、瀑布式开发项目背景下的文档范例和理论思辨。比如，书中用了大量的篇幅讨论“需求规格说明书”（SRS）的结构和规范性，详尽到令人发指的地步——每一个字段、每一个子条款的措辞都必须经过冗长的评审链条。对于习惯了轻量级文档、Wiki 页面和 Markdown 格式的开发者来说，这种严谨性显得有些沉重和过时。虽然作者们对“清晰性”和“无歧义性”的追求令人钦佩，但实践操作性上，我感觉它更适合做历史研究，而非日常工具使用。特别是关于用户手册的章节，很多例子都基于那些已经被淘汰的复杂桌面应用界面，现在的SaaS产品迭代速度之快，使得书中的“黄金准则”似乎总需要打个折扣才能套用。我得承认，它对软件文档理念的奠基作用是不可磨灭的，但作为一本“最佳实践”指南，它更像是一份优秀的“历史文献”。
评分如果要用一句话来概括我的阅读体验，那就是：这是一座关于软件文档历史和理论的宝库，但它不是一本使用说明书。书中展现的对语言精确性的执着，以及对软件设计哲学深入的探讨，是极其宝贵的。我特别欣赏作者们对于“技术债务”如何体现在文档中这一概念的早期论述，这在当时无疑是具有前瞻性的。但对于一个急于提升自己日常文档效率的从业者来说，这本书的“即时满足感”很低。它更像是一部需要反复研读、边做笔记边对照自己工作进行反思的著作。我发现自己经常需要暂停阅读，去翻阅旧的项目文档，看看哪些地方可以参照书中的原则进行优化，但这些优化往往需要付出额外的、不成比例的时间成本。例如，书中提倡的详尽的变更日志（Change Log）规范，虽然理论上完美，但在当今持续集成/持续部署的背景下，自动化工具生成的内容往往在数量和速度上就压倒了人工的精心撰写。所以，这本书的价值在于其思想的深度和对软件沟通本质的洞察，而非提供一套可以直接复制粘贴到你的 Jira 任务描述中的模板。
评分若出中文版，可考虑副标题“也写给不编程的人”。推荐。
评分原版还可以(Joel的的收录么),翻译的就有点糟了.
评分若出中文版，可考虑副标题“也写给不编程的人”。推荐。
评分这些文章网上都可以找到原文。
评分原版还可以(Joel的的收录么),翻译的就有点糟了.
相关图书
本站所有内容均为互联网搜索引擎提供的公开搜索信息，本站不存储任何数据与内容，任何内容与数据均与本站无关，如有需要请联系相关搜索引擎包括但不限于百度，google,bing,sogou 等
© 2026 book.wenda123.org All Rights Reserved. 图书目录大全 版权所有