Grails documentation is not the holy grail
Well, I obviously haven’t had much to write about this year. That is probably going to change. A new client I am working with is using Groovy and Grails and I’m in the process of learning them both. It’s been about 4 weeks, and one thing is clear – beyond the introduction tutorial, the Grails documentation sucks.
The documentation at grails.org is available online in Wiki format. This means that the community can help to make it suck less. However, whoever wrote the Wiki software obviously thought that useless Ajax functionality was more important than important things like edit timestamps and revision comments.
Nonetheless, I’ll do my part to update the documentation when I find it outdated, missing essential information, or just plain wrong.
Besides the first tutorial on creating a Grails application, the grails.org website has not been the primary source of information for me to learn about Grails. Most of my information comes from nabble.com and markmail.org, usually found with numerous Google searches. I’ll also recommend the Pragmatic Bookshelf Groovy Recipes book, it’s a great resource for example code.
Ok, time for me to stop complaining and get back to work.