开源Java项目（具有良好的设计文档）

Question

我正在写一些关于一些设计良好的开源Java项目的建议，其中包含良好的设计文档 - 尤其是在设计的设计中，随着越来越多的人研究（以及提出的缺陷？），设计如何演变。 / p>

我记得在阅读Joel Spolsky关于软件产品（或项目）中大部分价值来自良好设计的评论。虽然他发表了一个很好的功能规范（CoPilot）的例子，但他（遗憾地）没有公布这个功能规范如何随后转变为技术规范和最终产品的设计。

目前，我正在尝试参与开源项目，以提高我的Java技能。我处于一个稳定的地方（为了进步）我需要更深入地了解项目如何从功能需求发展到技术设计，这样我才能在收敛到目前存在的代码库之前对所考虑的问题进行评估。 / p>

我所看到的大多数开源Java项目似乎都没有关于在融合到今天存在的设计（代码）之前考虑了哪些问题的任何信息。我确信有人（在某些时候）必须（至少）发布一个类图，模拟不同实体之间的关系以及为什么以这种方式设计它的理由。

任何指针都会非常感激。

亲切的问候， Dinuk

Answer 1

看看Apache项目。他们大多数都有很好的文档记录，并且有活跃的开发人员。用户邮件列表，您可以在其中获取超出文档记录的信息。除了查看邮件列表上的过去对话之外，您还会看到出现了哪些问题以及它们是如何解决的。