Drupalcontribute Devel

Un DrupalConTribute es un evento de uno o dos días en los que un grupo de personas se reúnen para contribuir en un tema específico en Drupal.org. En ésta ocasión proponemos trabajar con el módulo Devel.

Desde hace unas semanas Pedro Cambra y yo colaboramos como comantenedores del módulo, el cual está en la lista de los más instalados y actualmente cuenta con:

• 128 bugs activos (290 issues en total).
• Sólo la parte de emailing dispone de tests. Hay que crear tests que verifiquen todo lo posible de la funcionalidad del módulo.
• No existe documentación oficial aparte del README.txt.

Objetivos del evento

• Realizar una limpieza de la issue queue. Esto se conoce en la comunidad como triage y sirve para detectar duplicados, solicitar información adicional y asignar los estados correspondientes a cada issue. Las personas que no deseen entrar al código fuente del módulo pueden ser de gran ayuda en esta tarea.
• Revisar y cerrar el mayor número posible de issues. Los commits que se apliquen tendrán autoría, con lo que aparecerán en el perfil del autor como una contribución al módulo. Sólo podremos comitear bug fixes durante el evento, ya que la política del módulo es que los commits que incluyan funcionalidad nueva deben ser aprobados por Moshe Weitzman (el creador del módulo).
• Los parches deben aplicarse primero sobre la versión del módulo para Drupal 8 y luego aplicarse sobre la versión de Drupal 7, con lo que este evento es una oportunidad perfecta para probar algunas funcionalidades de la próxima versión de Drupal.
• Añadir tests funcionales que cubran la mayor parte del módulo tanto en Drupal 7 como en Drupal 8. Para los comandos de Drush, consideraremos implementar tests de PHPUnit.
• Crear una sección de documentación que explique la funcionalidad principal del módulo.
• Mostrar los procesos de contribución a gente que no lo haya hecho antes para que participen en ellos.

Todos los issues que tratemos, documentación que editemos y tweets que enviemos, y fotos que subamos a flickr en referencia a este evento llevará el tag #develcontribute para que podamos evaluar el impacto posteriormente. Prepararemos una lista de issues categorizadas y crearemos nuevas issues para aspectos como testing con simpletest y documentación.

Requisitos

No es necesario haber contribuído antes en algún proyecto de Drupal.org, así que quien quiera aprender a hacerlo es bienvenido ya que podrá ver y participar en el proceso.

Para todas las áreas en las que se van a trabajar es necesario que cada participante presencial:

• Traiga el portátil con el que va a trabajar.
• Tenga una cuenta de usuario en http://drupal.org.

Para trabajar con las issues

• Leer la información sobre cómo trabajar con la lista de issues en Drupal.org.
• Una instalación limpia de Drupal 7 y Drupal 8 con su correspondiente site local (ej: d7.localhost y d8.localhost) más una copia de base de datos de cada uno que permita restaurar el site al punto inicial (para poder empezar desde cero cuando sea necesario.
• Un editor de texto con ambos sites configurados para poder revisar y editar el código fuente.
• Un clon de git del módulo Devel en cada instalación.

Para trabajar con la documentación

• Buenas aptitudes de redacción en inglés.
• Revisar la documentación sobre cómo documentar proyectos en Drupal.org.

Para las tareas de testing automatizado

• Mismos requisitos definidos para las issues, y además:
• Activar el módulo testing.
• Leer la documentación sobre Simpletest en Drupal.org.
• Revisar los tests actuales del módulo Devel.
• Opcional: revisar los test de PHPUnit de Drush para poder implementar tests de los comandos de Devel.

Organización, Participación y servicios

El evento tendrá lugar el sábado 15 de diciembre de 10 a 18 horas en las oficinas de BeCode en Valencia (con una capacidad máxima de 15 personas). Se puede participar remotamente, para lo cual se recomienda reunirse con el grupo local.

La Asociación Española de Drupal estudiará apoyar de alguna forma el evento.

Para participar en el evento basta con registrarse en ésta misma web en el enlace que hay al final de la descripción.

Links de interés

• Listado de tests a implementar.
• Issues con el tag #develcontribute.
• Discusión del grupo de Valencia.
• Discusión del grupo de Madrid.
• Discusión del grupo de Barcelona.