The users will not read the GroovyDoc, so make sure to put the info into the docs. But use prose instead of GroovyDoc there. If you want to keep the info here as well, convert them to correct GroovyDoc by using /** and @param.