diff --git a/README.md b/README.md index 89a74ae..d9f3fd6 100644 --- a/README.md +++ b/README.md @@ -50,7 +50,7 @@ Chinese translations for classic IT resources. 1. [`Python` Philosophy(`Python`哲学)翻译及简析](python-philosophy/README.md) 既有指明大是大非的理念,又有指导细节操作的准则;既有谆谆教导的推荐,也有声色俱厉的禁止。 1. [`Java`的通用`I/O` `API`设计](generic-io-api-in-java-and-api-design/README.md) - 给出了一个通用`Java` `IO` `API`设计,更重要的是,给出了这个`API`设计本身的步骤和过程,这让`API`设计有些条理。文中示范了从 普通简单实现 整理成 正交分解、可复用、可扩展、高性能、无错误的`API`设计 的过程。这个很值得理解和学习!设计偏向是艺术,一个赏心悦目的设计,尤其是`API`设计,旁人看来多是妙手偶得的感觉,如果能有些章可循真是一件美事。给出 _**减少艺术的艺术工作量**_ 的方法的人是 **大师**。 + 给出了一个通用`Java` `IO` `API`设计,更重要的是给出了这个`API`设计本身的步骤和过程,这让`API`设计有些条理。文中示范了从 普通简单实现 整理成 正交分解、可复用、可扩展、高性能、无错误的`API`设计 的过程,这个过程是很值得理解和学习!设计偏向是艺术,一个赏心悦目的设计,尤其是`API`设计,旁人看来多是妙手偶得的感觉,如果能有些章可循真是一件美事。给出 _**减少艺术的艺术工作量**_ 的方法的人是 **大师**。 1. [`API`设计原则 - `Qt`官网的设计实践总结](api-design-principles-from-qt/README.md) `Qt`的设计水准在业界很有口碑,一致、易于掌握和强大的`API`是`Qt`最著名的优点之一。此文既是`Qt`官网上的`API`设计指导准则,也是`Qt`在`API`设计上的实践总结。虽然`Qt`用的是`C++`,但其中设计原则和思考是具有普适性的(如果你对`C++`还不精通,可以忽略与`C++`强相关或是过于细节的部分,仍然可以学习或梳理关于`API`设计最有价值的内容)。整个篇幅中有很多示例,是关于`API`设计一篇难得的好文章。 1. [`GUI` & `CLI`原则](gui-and-cli-principles/README.md) diff --git a/generic-io-api-in-java-and-api-design/README.md b/generic-io-api-in-java-and-api-design/README.md index 5f20670..0ef7e39 100644 --- a/generic-io-api-in-java-and-api-design/README.md +++ b/generic-io-api-in-java-and-api-design/README.md @@ -3,11 +3,10 @@ ### :apple: 译序 -原文[A generic input/output API in Java](http://www.jroller.com/rickard/entry/a_generic_input_output_api)(by Rickard Öberg)中给出了一个通用`Java` `IO` `API`设计,并且有`API`的`Demo`代码。 +本文给出了一个通用`Java` `IO` `API`设计,并且有`API`的`Demo`代码。 -更重要的是,这篇文章给出了这个`API`设计本身的步骤和过程,这让`API`设计有些条理。 -文中示范了从 普通简单实现 整理成 正交分解、可复用、可扩展、高性能、无错误的`API`设计 的过程。 -这个很值得理解和学习! +更重要的是给出了这个`API`设计本身的步骤和过程,这让`API`设计有些条理。 +文中示范了从 普通简单实现 整理成 正交分解、可复用、可扩展、高性能、无错误的`API`设计 的过程,这个过程是很值得理解和学习! 设计偏向是艺术,一个赏心悦目的设计,尤其是`API`设计,旁人看来多是妙手偶得的感觉,如果能有些章可循真是一件美事。