Clean architecture 二次审校

translation

Clean Architecture(审校计划)

序言

1. 前后文不一致（倒数第3段）
   译文：而本书试图探索的则是一条洁净的路线。
   建议：而本书试图探索的则是一条整洁的路线。

第一部分 概述 1-16

第1章 设计与架构究竟是什么

第2章 两个价值维度的故事

第二部分 从基础构件开始：编程方式 21-51

第3章 编程范式总览

第4章 结构式编程

1. 数学逻辑问题
   

原文：Ultimately, we can say that mathematics is the discipline of proving provable statements true. Science, in contrast, is the discipline of proving provable statements false.
错误点：不可证明的结论，意思是非真非假，所以没法证明也没法证伪。这里的意思和后文测试小节里提到的证伪只能被应用到可证明的程序上是呼应的。
建议：科学研究则是要将可证明的结论证伪。

第5章 面向对象编程

建议：冯·诺依曼

第6章 函数式编程

第三部分 设计原则 55-81

第7章 SRP：单一责任原则

第8章 OCP：开闭原则

第9章 LSP：里氏替换原则

第10章 ISP：接口隔离原则

第11章 DIP：依赖反转原则

第四部分 组件构建原则

第12章 组件

第13章 组件构建原则

复用/发布等同原则

共同闭包原则

第14章 组件耦合

1. 字体不一致
   

稳定抽象原则

1. 逻辑混乱，语言过于饶舌
   
   原文：“For some reason, they are either very abstract with few dependents or very concrete with many dependents.”
   错误点：这里的过于抽象，以至于外向依赖不够违背了原意，原意是太抽象了但是入向依赖不够，结果就是稳定抽象不满足，后面也是同样的道理
   建议：它们要么过于抽象但依赖不足，要么就是过于具体而被依赖的太多。

第五部分 软件架构

第15章 什么是软件架构

1. 不符合行业术语 + typo
   
   原文：dependency injection framework
   错误点： 翻译成了依赖注射入架
   建议：不应过早地采用依赖注入框架（dependency injection framework）

第16章 独立性

第17章 划分边界

第18章 边界剖析

第19章 策略与层次

第20章 业务逻辑

第21章 尖叫的软件架构

第22章 极净架构

第23章 展示器和谦卑对象 （这里的序号有错）

第24章 不完全边界

第25章 层次和边界

第26章 Main 组件

第27章 服务：宏观和微观

第28章 测试边界

第29章 整洁的嵌入式架构

第六部分 240-321

第30章 数据库只是实现细节
1. 不符合原文

原文：“Relational database systems that force the data to be organized into tables and accessed with SQL have much more to do with the latter than with the former. The data is significant. The database is a detail.”
错误点：这里其实说明关系型数据库只关注了从磁盘上存储、读取数据，所以结合前文，应该是“更偏向后者”的意思
建议：关系型数据库强制我们将数据存储成表格并以SQL访问，主要是为了后者。

第31章 Web是实现细节

第32章 应用程序框架是实现细节

第33章 设计与架构究竟是什么

第34章 拾遗

附录A 架构设计考古