Skip to content

Commit

Permalink
update translation of ch10
Browse files Browse the repository at this point in the history
  • Loading branch information
yingang committed Feb 29, 2024
1 parent be14abc commit 00c651e
Show file tree
Hide file tree
Showing 5 changed files with 42 additions and 20 deletions.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@
- [第 7 章 不同的层,不同的抽象](docs/ch07.md)
- [第 8 章 降低复杂性](docs/ch08.md)
- [第 9 章 在一起更好还是分开更好?](docs/ch09.md)
- [第 10 章 通过定义规避错误](docs/ch10.md)
- [第 10 章 通过定义来规避错误](docs/ch10.md)
- [第 11 章 设计它两次](docs/ch11.md)
- [第 12 章 为什么要写注释呢?有四个理由](docs/ch12.md)
- [第 13 章 注释应该描述代码中不明显的内容](docs/ch13.md)
Expand Down
4 changes: 2 additions & 2 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
- [第 7 章 不同的层,不同的抽象](ch07.md)
- [第 8 章 降低复杂性](ch08.md)
- [第 9 章 在一起更好还是分开更好?](ch09.md)
- [第 10 章 通过定义规避错误](ch10.md)
- [第 10 章 通过定义来规避错误](ch10.md)
- [第 11 章 设计它两次](ch11.md)
- [第 12 章 为什么要写注释?有四个理由](ch12.md)
- [第 13 章 注释应该描述代码中不明显的内容](ch13.md)
Expand All @@ -36,6 +36,6 @@

这两个项目均有收到并处理一些内容修正的 PR,但即使是 Cactus-proj,最新的几个 PR 也处于长期未处理的状态,应该都已经暂停维护了,然后基于 Cactus-proj,包含内容修复最多的是 [luojiego](https://github.com/luojiego/A-Philosophy-of-Software-Design-zh) 的 Fock,于是就基于这个创建了自己的 [Fork](https://github.com/yingang/aposd-zh)。除了一边阅读一边校对,也摸索着更新了相关的部署脚本,同样部署到 [GitHub Pages](https://yingang.github.io/aposd-zh/) 上,可直接在线阅读。

从提交历史来看,[gdut-yy](https://github.com/gdut-yy) 应该是主要的翻译贡献者,[liquid207](https://github.com/liquid207)[wanghuanwei](https://github.com/wanghuanwei)[luojiego](https://github.com/luojiego)[BlackGlory](https://github.com/BlackGlory) 也都贡献了比较多的翻译修正,[inkydragon](https://github.com/inkydragon) 则主要负责了 LaTeX 和 PDF 相关的工作,不确定历史是否挖掘充分,所有提到未提到的贡献者,一并感谢!
从提交历史来看,[gdut-yy](https://github.com/gdut-yy) 应该是主要的翻译贡献者,[liquid207](https://github.com/liquid207)[wanghuanwei](https://github.com/wanghuanwei)[luojiego](https://github.com/luojiego)[BlackGlory](https://github.com/BlackGlory) 也都贡献了比较多的翻译修正,[inkydragon](https://github.com/inkydragon) 则主要负责了 LaTeX 和 PDF 相关的工作以及格式规范、持续集成等方面的工作,不确定历史是否挖掘充分,所有提到未提到的贡献者,一并感谢!

如果您在阅读过程中,发现有翻译不当的地方,或者有其他建议,欢迎提交相应的 PR 或 Issue。
2 changes: 1 addition & 1 deletion docs/ch01.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@

> This book has two overall goals. The first is to describe the nature of software complexity: what does “complexity” mean, why does it matter, and how can you recognize when a program has unnecessary complexity? The book’s second, and more challenging, goal is to present techniques you can use during the software development process to minimize complexity. Unfortunately, there isn’t a simple recipe that will guarantee great software designs. Instead, I will present a collection of higher-level concepts that border on the philosophical, such as “classes should be deep” or “define errors out of existence.” These concepts may not immediately identify the best design, but you can use them to compare design alternatives and guide your exploration of the design space.
这本书有两个总体目标。首先是描述软件复杂性的性质:“复杂性”是什么意思,为什么重要,以及当程序具有不必要的复杂性时如何识别?本书的第二个也是更具挑战性的目标是介绍可在软件开发过程中使用的技术,以最大程度地减少复杂性。不幸的是,没有简单的方法可以保证出色的软件设计。取而代之的是,我将提出一些与哲学紧密相关的高级概念,例如“类应该很深”或“通过定义规避错误”。这些概念可能不会立即确定最佳设计,但您可以使用它们来比较设计备选方案并指导您探索设计空间。
这本书有两个总体目标。首先是描述软件复杂性的性质:“复杂性”是什么意思,为什么重要,以及当程序具有不必要的复杂性时如何识别?本书的第二个也是更具挑战性的目标是介绍可在软件开发过程中使用的技术,以最大程度地减少复杂性。不幸的是,没有简单的方法可以保证出色的软件设计。取而代之的是,我将提出一些与哲学紧密相关的高级概念,例如“类应该是深的”或“通过定义来规避错误”。这些概念可能不会立即确定最佳设计,但您可以使用它们来比较设计备选方案并指导您探索设计空间。

## 1.1 如何使用这本书

Expand Down
Loading

0 comments on commit 00c651e

Please sign in to comment.