[vorg]

When you say improve, you should ask why the docs are broken in the first place.

I wrote a lot of doco for Groovy over 5 yrs ago, but it has a tendency to break between different versions of Groovy. E.g. this doco http://groovy.codehaus.org/JN2515-Closures I wrote stopped working after Groovy 1.5 because the Groovy despots suddenly decided to disallow try statements without a catch or finally clause for Groovy 1.6. I had to go through all my code and add finally{} throughout it all. I put the root problem down to the despots not taking work on the Groovy language spec (JSR-241) seriously.