Yes, I agree that documentation is really important to the success of Geronimo.
We have lots of changes in terms of security, web container integration mechanism as well as GEP improvements for G2.2, and we know some of information are not well documented yet. For the current status of G2.2 doc development, you may refer to http://cwiki.apache.org/GMOxDOC22/apache-geronimo-v22-documentation-development-status.html Beyond these items listed, I believe there are lots of topics to be updated such as new samples, screenshots and so on. Therefore, we would appreciate any individual who can contribute to the documents and especially for those who has successful experiences with configuration of certain components. As for the examples that you mentioned, in my understanding, G Doc already has certain topics for those: 1. Database security realm, you may refer to http://cwiki.apache.org/GMOxDOC22/database-sql-realm.html 2. Real samples, we have sample applications for test and evaluation, you may refer to http://cwiki.apache.org/GMOxDOC22/sample-applications.html#Sampleapplications-AvailableSampleApplicationsor WAS CE samples which can be deployed on Geronimo as well 3. Tutorial for various applications' development, which might not cover every corner by now but it would be applaudable**<http://www.iciba.com/applaudable/>if we could have more and more tutorials on website. For this part, you may refer to http://cwiki.apache.org/GMOxDOC22/developing-web-applications.html http://cwiki.apache.org/GMOxDOC22/developing-ejb-applications.html http://cwiki.apache.org/GMOxDOC22/developing-jpa-applications.html http://cwiki.apache.org/GMOxDOC22/developing-application-clients.html http://cwiki.apache.org/GMOxDOC22/developing-web-services.html We'd like to hear more about your comments to the document such as the documents are not well-orgnized? what kind of topics are missing? Or you can share your experience briefly, we can help to document? I think more details will do more help. Thanks alot. Jeff C On Tue, Sep 15, 2009 at 5:27 AM, Radim Kolar <[email protected]> wrote: > > > Quintin Beukes-2 wrote: > > > > They're all small errors, and I listed them because they can > > potentially damage Geronimo's image by complicating a user's > > experience. User experience is the biggest factor in a product's > > success. > > > I see it that biggest problem with Geronimo is lack of good documentation, > mainly good documentation on security is still missing. After reading users > mailing list for a while people asks for documents about: > > How to secure internal derby database from connections into geronimo from > outside? They want to have something like: for database XYZ user X and Y > can > connect. it can be probably done by binding security realm into database. > it > would be great if we can click it in gui. > > same thing for message queues. > > oh and deployment plans are another topic. There are some samples on doc > website but i would really like to see some real world example for example > web application with more modules, jpa and message queues. it took me > almost > entire day until i managed to write it correctly myself. > -- > View this message in context: > http://www.nabble.com/There%27s-still-hope-for-2.2...-tp25395776s134p25443963.html > Sent from the Apache Geronimo - Dev mailing list archive at Nabble.com. > >
