Maybe writing the JavaDoc helped them think out some design issues? Some of my most productive programming time has been sitting in a park with paper and a pencil. (Not billable, though, sigh.)