juanformoso/api-doc — pull request #19 by gastonfournier (2013-08-28 19:00:01+00:00)
Title: Agregado de @Documented

Hola Juan, acá te dejo por si te interesa, otra anotación que agregué. No está bueno el doble procesamiento de ambas anotaciones, pero me resultó mucho más simple para un proceso que recién comienza ya poder tener la documentación en unas pocas líneas:
@Documented(friendlyName = "register send", description = "Registers that an email will be sent to the user", group = "Miscellaneous", parameterNames = "email", "type"})
No tiene soporte a return types, pero se puede mergear con la anotación @Documentation. No probé mucho ese merge ya que sólo quería agregar algo de documentación en mi aplicación de manera rápida.
Saludos!