Would be great to have multiple format for the API Documentation Download.
PDF is great for speed light full text search and for printing.
—-
It would be nice to have docbook based documentation.
—-
The RoR documentation is a mess. RoR kicks ass, but it’s documentation is very confused. The actual API documentation is alright, but a beginner needs to reference the API, the wiki and the manual.
There needs to be a solid and concise documentation model. I have found the PHP system to be very good.
May I suggest something like PHP’s documentations(or better) + a Cookbook?
This would involve opening up the API documentation to threaded (not wiki) comments and a cookbook, which would be a combination of the manual and the wiki.