19 votos

¿Grails: Alternativas a la Doc de Grails?

La documentación creada por ejecutar grails doc no es completamente satisfactoria en mis ojos. Por ejemplo, las acciones de los controladores aparecen como propiedades en la documentación, aunque me gustaría tener una sección adicional para separar las acciones de propiedades reales (Cadenas, etc.).

Hay herramientas que funcionan en JavaDoc-como los comentarios y generar una mejor salida para Grails proyectos? Debe ser Grails-consciente (es decir, entiende que los cierres en los controladores son en realidad acciones) o permitir explícito de marcado (por ejemplo, un @section Actions comentario hace que el párrafo aparecen en una sección denominada "Acciones")

7voto

aholub7x Puntos 402

Echa un vistazo en el proyecto grails nuevo doc .

1voto

Srinath Anantha Puntos 88

Echa un vistazo a "Grails tiempo de ejecución Docs" plugin ( http://grails.org/plugin/grails-runtime-docs ). Se generará groovy documentación de tiempo de ejecución, incluyendo los métodos dinámicos, añadiendo "Método Dinámico Resumen" Y "Método Dinámico Detalle" en el código html generado docs y que constituyen su fuente de información. Es más Grails en cuenta y clasifica las clases en los Controladores, los Comandos, Dominios, Servicios y Bibliotecas de Etiquetas. Nota: soy un desarrollador grails y contribuyó con este open-source plugin de Grails mí mismo. Espero que les sea útil.

1voto

Captian Trips Puntos 61

Suena como que usted está ejecutando una versión anterior de Grails.

La última versión de Grails contiene muchas mejoras en grails doc. Además, Grails ahora recomienda las acciones de los controladores deben ser codificados como métodos en lugar de los cierres, que pueden tratar su problema.

Si usted está preocupado acerca de la actualización, he estado usando Grails desde el 2008 y siempre actualizar cuando las nuevas versiones de salir.

Nunca ha tomado más de un día para actualizar Grails, actualizar el código a la dirección de cualquier documentado "cambios recientes", ejecutar las pruebas y volver si me encuentra cualquier problema.

Desde la actualización es tan fácil, yo siempre trate de mantenerse al día con la última versión estable.

Por la forma en que los plugins pueden ser problemáticos. Usted debe, por supuesto, tienen pruebas para cualquiera de los plugins que uso. De hecho, el mejor de los plugins ya incluyen pruebas, que puede ejecutar.

Iteramos.com

Iteramos es una comunidad de desarrolladores que busca expandir el conocimiento de la programación mas allá del inglés.
Tenemos una gran cantidad de contenido, y también puedes hacer tus propias preguntas o resolver las de los demás.

Powered by:

X