From d2455bc99e7dfa2c7b21d38c3281f45731b92fb0 Mon Sep 17 00:00:00 2001 From: Jerry Lee Date: Thu, 30 Jul 2015 12:31:02 +0800 Subject: [PATCH] update home page --- README.md | 39 ++++++++++++------- .../README.md | 8 ++-- gui-and-cli-principles/README.md | 7 +++- 3 files changed, 35 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index 90c1562..bc63d04 100644 --- a/README.md +++ b/README.md @@ -7,39 +7,48 @@ Chinese translations for good english resources. 设计原则 ------------------ -- [`Python` Philosophy（`Python`哲学）翻译及简析](python-philosophy/README.md) -- [`Java`的通用`I/O` `API`设计](generic-io-api-in-java-and-api-design/README.md) -- [`GUI` & `CLI`原则](gui-and-cli-principles/README.md) +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`设计，旁人看来多是妙手偶得的感觉，如果能有些章可循真是一件美事。 +给出 _**减少艺术的艺术工作量**_ 的方法的人是 **大师**。 +1. [`GUI` & `CLI`原则](gui-and-cli-principles/README.md) +文中列出的`GUI`和`CLI`的原则：说明了两种`Interface`适合的场景和优劣；进而引导你去思考，面向用户或作为程序员的你，交互/操作 如何才能是高效的。 `Git` ------------------ -- [`Git`工作流指南](git-workflows-and-tutorials/README.md) -- [`Git` `2.1`有哪些新特性？](whats-new-git-2-1/README.md) - -`Java` ------------------- - -- [关于`Java`你可能不知道的10件事](10-things-you-didnt-know-about-java/README.md) +1. [`Git`工作流指南](git-workflows-and-tutorials/README.md) +这篇指南以大家在`SVN`中已经广为熟悉使用的集中式工作流作为起点，循序渐进地演进到其它高效的分布式工作流，还介绍了如何配合使用便利的`Pull Request`功能，体系地讲解了各种工作流的应用。行文中实践原则和操作示例并重，对于`Git`的资深玩家可以梳理思考提升，而新接触的同学，也可以跟着step-by-step操作来操练学习并在实际工作中上手使用。 +1. [`Git` `2.1`有哪些新特性？](whats-new-git-2-1/README.md) 分布式系统/大数据 ------------------ -- [Paxos Made Simple](paxos-made-simple/README.rst) +1. [Paxos Made Simple](paxos-made-simple/README.rst) 该论文给出描述一致性问题的概念、术语、算法，从复杂中抓取出了核心，给出了如此简单的描述。 另言简意赅地说明了多实例`Paxos`（`Multi-Paxos`），这是真正实践中使用的`Paxos`。可以说不读这篇论文你就不知道如何有效描述和交流一致性算法。 -- [`PaxosLease`：实现租约的无盘`Paxos`算法](paxoslease/README.rst) +1. [`PaxosLease`：实现租约的无盘`Paxos`算法](paxoslease/README.rst) 可以说是最简单且可以实际使用的`Paxos`算法变种。 +`Java` +------------------ + +1. [关于`Java`你可能不知道的10件事](10-things-you-didnt-know-about-java/README.md) +你是不是写`Java`已经有些年头了？还依稀记得这些吧： +那些年，它还叫做`Oak`；那些年，`OO`还是个热门话题；那些年，`C++`同学们觉得`Java`是没有出路的；那些年，`Applet`还风头正劲…… 但我打赌下面的这些事中至少有一半你还不知道。 + `Lisp` ------------------ -- [***Successful Lisp***中的`Lisp`书籍推荐](recommend-lisp-books/suggestions4further-reading-in-successful-lisp.md) +1. [***Successful Lisp***中的`Lisp`书籍推荐](recommend-lisp-books/suggestions4further-reading-in-successful-lisp.md) - 考虑到`Lisp`入门的难度，整理了[`Lisp`书籍推荐和点评](recommend-lisp-books/README.md) - 特别提这篇好文[【转】学习`Lisp`的书籍推荐](recommend-lisp-books/recommend-lisp-books.md) 其它 ------------------ -- [如何用`Linux`命令行管理网络：11个你必须知道的命令](how-to-work-with-network-from-linux-terminal/README.md) -- [为什么`Android`手机会越用越慢，如何提速？](why-android-phones-slow-down-over-time-and-how-to-speed-them-up/README.md) +1. [如何用`Linux`命令行管理网络：11个你必须知道的命令](how-to-work-with-network-from-linux-terminal/README.md) +1. [为什么`Android`手机会越用越慢，如何提速？](why-android-phones-slow-down-over-time-and-how-to-speed-them-up/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 cf18467..90e694d 100644 --- a/generic-io-api-in-java-and-api-design/README.md +++ b/generic-io-api-in-java-and-api-design/README.md @@ -5,11 +5,13 @@ 原文[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`代码。 -更重要的一点是，这篇文章给出这个`API`设计本身的步骤和过程，这让`API`设计有些条理。文中示范了从 普通简单实现 整理成 正确分解、可以复用、可扩展的`API`设计 的过程。 +更重要的是，这篇文章给出了这个`API`设计本身的步骤和过程，这让`API`设计有些条理。 +文中示范了从 普通简单实现 整理成 正交分解、可复用、可扩展、高性能、无错误的`API`设计 的过程。 这个很值得理解和学习！ -设计偏向是艺术，一个赏心悦目的设计，尤其是`API`设计，旁人看来多是妙手偶得的感觉，如果能有些章可循真是一件好事。 -给出 _**减少艺术的艺术工作量**_ 的方法的人是大师。 +设计偏向是艺术，一个赏心悦目的设计，尤其是`API`设计，旁人看来多是妙手偶得的感觉，如果能有些章可循真是一件美事。 + +给出 _**减少艺术的艺术工作量**_ 的方法的人是 **大师**。 `Java`的通用`I/O` `API`设计 ========================= diff --git a/gui-and-cli-principles/README.md b/gui-and-cli-principles/README.md index 2d74ace..de17dcb 100644 --- a/gui-and-cli-principles/README.md +++ b/gui-and-cli-principles/README.md @@ -5,7 +5,12 @@ 文章[Subversion UI Shootout](http://onlamp.com/pub/a/onlamp/2005/03/10/svn_uis.html "Subversion UI Shootout")比较了多个`GUI` `SVN`工具以及命令行的优劣。 -虽然说的是`SVN`工具，但文中列出的`GUI`和`CLI`的原则，值得单独拿出来看看。这里翻译一下。 +虽然说的是`SVN`工具，但文中列出的`GUI`和`CLI`的原则： + +- 说明了两种`Interface`适合的场景和优劣 +- 进而引导你去思考，面向用户或作为程序员的你，交互/操作 如何才能是高效的 + +值得单独拿出来看看。这里翻译一下。 PS： 交互思考有相通的之处，下面的几篇说了不错的话题，也可以看看：