Ashkelon y Confluence

Ashkelon es la tecnología tras JDocs.com. Permite indexar javadocs de varios proyectos y consultarlos por diferentes criterios.

• El interfaz es DHTML.
• Los datos se guardan en BD, la aplicación es un war.
• La indexación se solicita desde línea de comando apuntando a un directorio con ficheros java, o usando un project.xml de Maven.

Hay una versión lite en .war que usa mckoidb, incluye javadocs de varios proyectos, y no necesita configuración alguna. Ocupa 21Mb.



El formato por defecto de las páginas me parece horrible, y en general no le encuentro utilidad. Para consultar el javadoc ya uso el eclipse. Lo único curioso es el índice por autores.

Jdocs añade un enlace en cada elemento para que postees comentarios en un foro.



Otro tema: un proyecto que sí uso todos los días es el wiki Confluence. Es comercial, hay versión de 30 días. Se instala como .war.

Un wiki es un sitio web en el que todas las páginas son editables y comentables. Además se guarda un historial de cambios para retroceder a versiones anteriores.

Como en todos los wikis, se emplea una sintaxis rápida para formatear el texto. Por ejemplo:



h5. Esto es un título con heading 5

* esto sería un list item de html. _enfásis_ {code}código java formateado con colorines, etc.{code}

||cabecera de tabla||xxxx||

|celda1|celda2|

Etc.



Hay otros wikis como JSPWiki (gratuito), pero Confluence tiene más funcionalidad y es más atractivo visualmente. Confluence permite por ejemplo, su contenido en html o pdf. Se basa en webwork y una docena de tecnologías open. Puede integrarse con Jira (de la misma compañía), que es el mejor bugtracking que existe.

Confluence es una manera estupenda de compartir ideas e información sobre un proyecto.

aquí teneis un ejemplo de Confluence. Y este es el web.