Chris Johnston

I have one complaint against many open source projects and that is the lack of good documentation. An example of this happened yesterday, I wanted to find out if Hibernate 3.1 had a dialect for the Derby database. I searched the web site and the documentation and found that it did not. The only real note that I could find stated that there was experimental support for it, except that this support was for Hibernate 2.x.

I resigned myself to looking for a new database, one that was supported by Hibernate. So I downloaded the code and went to check out the HypersonicDB website. I also checked the 3.1 documentation to see what dialects were offered, once again, it said that Derby was not supported.

I decided to look inside the jar file to double check this. What I found was that there was a dialect for Derby. I have not tested it out, but since it is in the base jar file I can only assume that it is fully supported.

My question is why has the documentation not been updated to show this? If Derby is supported, it should be listed somewhere in the docs or on the website, and it is not.