Antora , the last iteration in the Asciidoctor ecosystem

Hi devs !!!!
We're back on stage starting the season with a new meetup next 20th of September in the Everis LivingLab !!!

https://antora.org/

Antora is the last iteration in the Asciidoctor ecosystem.

Asciidoctor has proven to be an excellent solution to write all sorts of documentation with its embedded features, extensibility and because it’s fun! "Docs as code" is no longer a new thing, and now Antora takes it a step further and offers a platform to aggregate, render and publish your documentation from different versioned repositories into ready-to-publish sites.
In this session we see how Antora can help you by simplifying your documentation pipeline, encouraging good practices and above all, ensure your documentation stays up with the quality of your code."

Speakers on this session will be :

>> Abel Salgado Romero ( @abelsromero )
Software engineer working at everis. Coming from a career focused on Content Management solutions around Java technologies has recently shifted to cloud solutions in Azure. Strong advocate for open source philosophy, and the importance of good testing and documentation. Contributes maintaining the asciidoctor-maven-plugin and lending a hand wherever he can.

>> Alex Soto ( @alexsotob )
Software engineer at Red Hat in Developers group. He is a passionate about Java world, software automation and he believes in the open source software model. Alex is the creator of NoSQLUnit project, member of JSR374 (Java API for JSON Processing) Expert Group, the co-author of Testing Java Microservices book for Manning and contributor of several open source projects such as Arquillian ecosystem or Asciidoctor. He is an international speaker presenting his talks at software conferences like Devoxx, JavaOne, JavaZone or JavaLand.

Don't forget to register in Meetup :

Register !!!!

Resumen Asciidoctor para mejorar tu documentación

Hola devs !!

El pasado 18 de Septiembre tuvimos la oportunidad de asistir a una fantástica presentación de AsciiDoctor a cargo de Alex Soto (@alexsotob) .

Alex nos introdujo al mundo de los distintos formatos de documentación y entre ellos AsciiDoctor como una opción muy ligera y con bajo índice de rastro en los documentos que nos permite tener la documentación del proyecto integrada con nuestro Sistema de Control de Versiones favorito para permitir la Colaboración y la trazabilidad de cambios.

Pudimos ver desde los caracteres de control más sencillos para crear títulos, negritas, listas ... hasta formas de crear fórmulas matemáticas. También comprobamos cómo se puede integrar perfectamente con tu IDE preferido y algunos consejos sobre dónde colocar los distintos ficheros de documentación para que sea más cómoda su gestión y trazabilidad (ej: requerimientos, decisiones de diseño, etc).

Entre los asistentes, surgieron algunas dudas a nivel de renderizado de la documentación y de los plugins disponibles a los que Alex dió respuesta y nos anunció que sin lugar a dudas, ya están trabajando en un editor WYSIWYG que no sólo sirva a equipos de desarrollo, sino a otras personas menos acostumbradas a trabajar con ficheros de texto en lugar de editores de documentos clásicos (Word, OpenOffice, etc).

Por cierto, la presentación -no podía ser menos- está realizada con AsciiDoctor ;-)

Aquí os adjuntamos el link al vídeo de la charla y la presentación. 

   Vídeo : http://www.youtube.com/watch?v=kep6Oe7LJmk

   Presentación : http://lordofthejars.github.io/bjug-asciidoctor/slides.html

Ya sabes, si quieres tratar tu documentación como tu código fuente, no lo dudes, y prueba Asciidoctor, seguro que no te decepcionará.

Un saludo,

¡Vuelta al cole! Asciidoctor para mejorar tu documentación (18/09)

¡Volvemos al cole!

Después de las vacaciones volvemos con energías renovadas, preparados para afrontar el año con un sinfín de ideas y propuestas sobre la mesa, que esperamos que a todos os motiven para seguir colaborando y creciendo en la dirección que vosotros, quienes formáis esta comunidad, deseáis.

Así pues, este próximo miércoles 18 a partir de las 19h os invitamos en la Fontana a nuestra primera charla del curso escolar, centrada en ese aspecto que a tantos les disgusta (y preocupa) que es la documentación y cómo se puede mejorar su gestión dentro del ciclo de vida de un proyecto.

"Doctor, Doctor, mi documentación está enferma. ¿Puedo tomar unas pastillas Asciidoctor?"

La documentación de un proyecto, incluyendo los manuales, tutoriales, requerimientos y diseño del software, es algo que rápidamente se olvida y posteriormente es desactualizada. Mientras que la codificación y el testing es hecho de una forma ágil, con la documentación no es así. Y así seguirá mientras se continúe escribiendo documentación en formatos binarios o propietarios fuera del sistema de control de versiones. En otras palabras, hasta que la documentación no sea tratada como código. 

En esta presentación y gracias a Alex Soto (@alexsotob) vamos a examinar los problemas asociados a escribir documentación en formatos binarios y cómo escribirlos en formato AsciiDoc puede ayudarnos a crear documentación de una forma ágil. También examinaremos la estructura que debe seguir la documentación para que los desarrolladores la hagan suya y se mantenga actualizada. Seréis testigos de cómo la documentación cobra vida cuando cada cambio realizado en ésta queda trazado, y cómo se puede colaborar en la elaboración de documentos de la misma forma que se hace con el código fuente.

Alex es Ingeniero Informático especializado en tecnologías enterprise, automatización de tests y continuous delivery, siempre en un entorno basado en Java. Cree firmamente en el modelo open source y como pueden ayudar a las compañías a desarrollar productos más rápidos y de una forma más segura. Ha colaborado en diferentes proyectos open source como Asciidoctor, Thymeleaf, Flyway o Spark, y es el desarrollador principal de NoSQLUnit. También ha realizado diferentes conferéncias en eventos como la Devoxx, LinuxTag o PuppetBaseCamp.

¡Esperamos veros a todos este próximo miércoles con energías renovadas!