Для класса или метода Groovy или Java я бы обычно включал любую документацию на уровне API в комментарий документа (он же комментарий Javadoc), а не в обычный комментарий. Каков аналогичный способ добавления таких комментариев к сценарию Groovy?
Меня лично не очень волнует, подберет ли инструмент Javadoc документацию. Однако документация о назначении скрипта Groovy кажется концептуально аналогичной документальному комментарию к классу; поэтому я интуитивно ожидаю, что они будут в комментарии к документу. Если моя интуиция неверна и теги документа не являются стандартным способом комментирования смысла сценария Groovy, какой является предпочтительным методом документирования назначения сценария?