Skip to content

Commit

Permalink
add codehaus-manifesto to index README
Browse files Browse the repository at this point in the history
  • Loading branch information
oldratlee committed Oct 21, 2018
1 parent 705933f commit 9a01971
Show file tree
Hide file tree
Showing 2 changed files with 8 additions and 6 deletions.
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,8 @@ Chinese translations for classic IT resources.

1. [`Python` Philosophy(`Python`哲学)翻译及简析](python-philosophy/README.md)
既有指明大是大非的理念,又有指导细节操作的准则;既有谆谆教导的推荐,也有声色俱厉的禁止。
1. [Codehaus宣言:技术管理与开源项目运营之道](codehaus-manifesto/README.md)
`Codehaus`:协作构建开源项目的社区,强烈强调现代语言,并开发聚焦于满足实际需求的高质量组件。`Groovy``Jetty``Gradle``XStream``Jackson``Drools``jMock``EasyMock``Grails``XDoclet``QDox``Esper``Mule``Janino``JBehave``Stomp` 以及其他数以百计开源项目,都得感谢`Codehaus`社区。很多项目听起来都是如雷贯耳吧,而这份精小的`Codehaus`宣言是`Codehaus`多年在技术管理与开源项目运营上的思考、总结与领悟,相信非常值得一读!**`Codehaus`致敬!!**
1. [`Java`的通用`I/O` `API`设计](generic-io-api-in-java-and-api-design/README.md)
给出了一个通用`Java` `IO` `API`设计,更重要的是给出了这个`API`设计本身的步骤和过程,这让`API`设计有些条理。文中示范了从 普通简单实现 整理成 正交分解、可复用、可扩展、高性能、无错误的`API`设计 的过程,这个过程是很值得理解和学习!设计偏向是艺术,一个赏心悦目的设计,尤其是`API`设计,旁人看来多是妙手偶得的感觉,如果能有些章可循真是一件美事。给出 _**减少艺术的艺术工作量**_ 的方法的人是 **大师**
1. [`API`设计原则 - `Qt`官网的设计实践总结](api-design-principles-from-qt/README.md)
Expand Down
12 changes: 6 additions & 6 deletions codehaus-manifesto/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
原文链接: [Codehaus Manifesto](https://github.com/codehaus/www-codehaus-org/blob/master/app/manifesto.md) PS: [Codehaus下线前最近存档 2015-02-17](https://web.archive.org/web/20150217163243/http://www.codehaus.org:80/customs/manifesto.html)
原文链接: [Codehaus Manifesto](https://github.com/codehaus/www-codehaus-org/blob/master/app/manifesto.md) PS: [Codehaus下线前最近的存档 2015-02-17](https://web.archive.org/web/20150217163243/http://www.codehaus.org:80/customs/manifesto.html)

<img src="streetlight_manifesto.png" width="20%" align="right" >

Expand Down Expand Up @@ -26,19 +26,19 @@ PS: `Codehaus`大约于2015年4月下线,更多关于`Codehaus`的信息可以
1. `Codehaus`观察到,基于指标、活跃时间和指派任务的分析,贡献更多的提交者在项目上有更大的话语权。
1. `Codehaus`是鼓励人们持续做出代码的地方,而不是用官僚流程把人们的项目框在一起的地方。
1. `Codehaus`鼓励项目追求质量和频繁的小发布。
1. `Codehaus`鼓励提交者为成敬人有礼的朋友,尽可能地与大家碰面交流。面对面优于邮件。
1. `Codehaus`鼓励提交者成为敬人有礼的朋友,尽可能地与大家碰面交流。面对面优于邮件。
1. `Codehaus`支持多样性(在合适时),而不是强制一统与同质。
1. `Codehaus`在吸纳提交者上设定高标准,引荐是常见的做法。新提交者期望能表现出代码水准以及优秀的品格。其成熟与才智应已有展现(如果年轻,在早年应该就展现出来了)。
1. 对于已有项目,新提交者期望在开始时先慢慢贡献一些小的不紧急的提交,之后再承担更大的自主的提交。
1. `Codehaus`在准入项目上设定高标准。项目应该是已经发布的或是接进发布的
1. `Codehaus`在吸纳提交者上设定高标准,引荐是常见的做法。新进的提交者期望要展示出代码水准以及优秀的品格。其成熟与才智应已有展现(如果年轻则应该在他早年就展现出来了)。
1. 对于已有项目,新进的提交者期望在开始时先慢慢贡献一些小的不紧急的提交,之后再承担更大的自主的提交。
1. `Codehaus`在准入项目上设定高标准。项目应该是已经发布的或是接近发布的
1. `Codehaus`鼓励人们在邮件沟通上要简明扼要,并注重互联网的礼仪。十篇长文来证明一个问题是个拙劣的方式;更好的方式是一个(失败的)单元测试。
1. 当争论不定时,专制是正解。

# 原文及点评

点评来自 [**@_ShawnQianx_**](http://weibo.com/shawnqianx) 2018年9月的技术分享。

**_Qian Sir_** 之点评一字未动,貌似随性又犀利劲到的点评让内容更多一分神采飞扬
**_Qian Sir_** 之点评一字未动,貌似随性又犀利劲到的点评让内容更多了一分神采飞扬

因为这份点评火力十足,个人觉得对原文原义的口感影响不少,所以没有直接放到译文中,以免你先入为主、断章取义影响对原文原义的品味。

Expand Down

0 comments on commit 9a01971

Please sign in to comment.