转自：http://www.iteye.com/topic/71565
一个好的项目总是有很多的文档，一个失败的项目总是有各种理由没有文档或很少的文档。所有我们有理由来比较一下四个平台的文档。
openI的项目相对来说比较的小，文档可能也少一些，
| Installation Document | As Mick Jagger would say -- "Start me up" |
| User Guide | Instructions on creating/modifying analysis |
| Architecture Overview | Oh yeah, there was some design work |
| Java Doc | Oh yeah, there is internal documentation |
文档虽少，主要的都有了，
实际上，这也是每个项目都应该有的文档了，java doc文档实际还是很必要的，方便查询API
jaspersoft的文档
| 分类 | 描述 | 数目 |
| Books |
|
|
| Report Samples |
|
|
| Articles |
|
|
| JasperServer |
|
|
| iReport |
|
|
| JasperReports |
|
|
| JasperETL |
|
|
| JasperSource Tips and Tricks |
|
|
Jaspersoft的文档不可谓不多，而且集中在report上，大家也都知道，JasperSoft的jasperreport是业界领先的一种报表方式。而iReport则是jasperReport的设计器，好的report都是 有自己的设计器的，因为报表的种类很多，不可能把所有的情况都考虑到，所以想要需要自己的设计器。相对于国内的智能平台，光报表这方面来说的话，就没有自己的设计器，所以要想开发一些新的报表样式就得定做，而且不容易管理，修改。所以设计器还是很必要的，无论是做成RCP还是web形式。
SpagoBI的文档
How_To—1.6.doc.zip
How_To—1.6.pdf.zip
QuickStart—0.9.2.doc.zip
QuickStart—0.9.2.pdf.zip
SpagoBI_JBoss_Installation_Manual-1.4.3.doc.zip
SpagoBI_JBoss_Installation_Manual-1.4.3.pdf.zip
SpagoBI_JOnAS_Installation_Manual-1.4.3.doc.zip
SpagoBI_JOnAS_Installation_Manual-1.4.3.pdf.zip
SpagoBI_eXoTomcat_Installation_Manual_1.4.3.doc.zip
SpagoBI_eXoTomcat_Installation_Manual_1.4.3.pdf.zip
spagoBI的文档只有怎么安装的，关于它的组件的文档相对就少了，可能是开发着文档只有在进入他们的社区或者是在社区开发者内部才有的吧。顺便说一下，spago本身还有自己的cms , portlet , workflow.实力绝对不容小看
pentaho的文档也非常的丰富
Pentaho Getting Started Guide
Pentaho AJAX Guide
Pentaho Security Guide
Pentaho Subscriptions
Software Quality Reports for Bugzilla Getting Started Guide
Software Quality Reports for Bugzilla Solution Documentation
Pentaho Cube Designer User Guide
Pentaho Creating Solutions
Pentaho Data Mining Experimenter Tutorial
Pentaho Data Mining Explorer Guide
Pentaho SDK
Pentaho Advanced Installation Guide
Pentaho Customizing Deployments
Pentaho Advanced Reporting Guide
Pentaho Component Builder's Guide
Pentaho Dashboard Builder's Guide
Pentaho Internationalization Guide
Pentaho BI Design Studio User Guide
Pentaho Report Design Wizard User Guide
Pentaho Report Designer User Guide
Pentaho Report Bursting Guide
Pentaho Jasper Report and BIRT Integration
Pentaho Using System Actions to Control Data Access
Session and Global Filter Guide
从文档的丰富程度也看出pentaho的体系相对较大，不过文档倒是覆盖的面比较广。其中的Pentaho Report Design Wizard User Guide 和
Pentaho Report Designer User Guide 是针对Pentaho Report Design的，一个基于eclipse平台的报表设计器。和jaspersoft一样，它把报表跟报表设计器飞开了，spagoBI好像是没有单独的报表设计器。它都是集成在一个WEB平台里面的。
Pentaho AJAX Guide 是它自己的一个AJAX工具包的开发文档，从pentaho网站的漂亮程度看的出来。Pentaho对于美观还是非常的注重的。
Pentaho Cube Designer ，Pentaho Data Mining ， Pentaho Dashboard Builder's ，Pentaho Internationalization ， Pentaho BI Design Studio 则是它的各个组件的开发文档。对于国际话还有专门的文档，看来pentaho 在开发的一开始就没打算之针对英语市场，spagoBI也有国际话，
cms和portlet都应该有吧，jaspersoft有没有我就不知道了，
pentaho也和另外的报表有集成，Jasper Report and BIRT Integration ，也算是业界主流的报表吧,spagoBI也跟其他有集成，后面会介绍的。
下一篇将会介绍各自的Demo。
