[DrupalCampSpain2018] Contribuir a Drupal

1. Drupal
Contribuir
Ruben Egiguren (keopx)
26/05/2018

2. Me podéis encontrar en:
▸ Blog: www.keopx.net
▸ Drupal: www.drupal.org/u/keopx
▸ Twitter: @regiguren
Me llamo
Ruben Egiguren
(keopx)

3. Podéis encontrarnos en:
▸ Web: www.biko2.com
▸ Drupal: www.drupal.org/Biko2
▸ Twitter: @biko2
Trabajo en

4. Introducción

5. Introducción
Objetivo
▸ Crear las bases para contribuir a Drupal.
▸ Facilitar recursos para poder comenzar.
▸ Tener un entorno para poder continuar en el
futuro.
▸ Pautas para no morir en el intento.

6. Por dónde empezar
Prepararnos para el sprint
▸ Regístrate en drupal.org.
▸ Leernos la documentación para novatos y
conocer el proceso a seguir.
▹ https://www.drupal.org/novice
▸ Instalar el entorno LAMP o similar.
▹ docker-compose: Linux & Mac:
▹ https://github.com/keopx/docker-drupa
l-contrib
▹ Acquia Dev Desktop
▹ Otros.

7. Por dónde empezar
Prepararnos para el sprint
Configura un cliente de IRC o similar.
▸ https://www.drupal.org/irc
▹ Únete a los canales #drupal,
#drupal-contribute, #drupal-es y
relacionados.
▸ https://drupalchat.eu/
▸ Otras opciones
▹ También se puede usar Slack o HipChat si
se hace en un grupo específico, pero el IRC
es un buen lugar.

8. Por dónde empezar
Atribuciones

9. Por dónde empezar
Estados de las issues
● Status settings of issues
● Templates for issue status transitions
RTBC

10. Por dónde empezar
Prepararnos para el sprint
▸ Configurar un IDE con los coding standards de
Drupal.
▹ https://www.drupal.org/coding-standards
▹ Herramientas adicionales:
▹ Coder
▹ PAReview.sh
* Si no cumples los coding standards tus
parches/módulos/temas nunca serán
publicados.
* Los módulos/themes se pueden publicar, pero no pasarán a estar revisados.

11. Por dónde empezar
Más recursos
▸ Importante leerlo: Recursos para contribuir,
generación de parches, como aplicarlos, etc.
▹ https://www.drupal.org/contribute/development
▸ Conocer una experiencia real y ver cómo hacerlo:
▹ http://2014.drupalday.es/sesion/publica-tu-proye
cto-en-drupalorg.html
▹ Video: https://vimeo.com/113362254
▹ Slides:
http://2014.drupalday.es/sites/default/files/
publica_tu_proyecto_en_drupal.org_.pdf

12. Contribuir a Drupal

13. No es difícil
▸ Contribuir al core no significa que tengas que
ser un crack.
▸ Hay tareas de todo tipo y de todos los niveles,
pero antes es necesario leerse estos apuntes
para conocer los procesos a la hora de
contribuir.
▸ Hasta yo lo he hecho :D

14. Novice
▸ Para empezar a contribuir lo primero es buscar
una issue novice.
▸ Es el mejor camino para empezar a realizar las
primeras aportaciones.
▸ Para ello podemos usar el siguiente enlace:
▹ https://www.drupal.org/project/issues/sear
ch/drupal?project_issue_followers=&issue
_tags_op=%3D&issue_tags=Novice
▸ Recomendación usar Dreditor (plugin Chrome)

15. Novice - interdiff
▸ Para realizar los parches que se actualicen, es
necesario añadir los ficheros interdiff para
facilitar al resto de colaboradores la lectura de
los cambios entre un parche y otro.
▸ El proceso parece complejo, pero al final resulta
más sencillo de lo que es.
▹ https://www.drupal.org/documentation/git/i
nterdiff
Nota: Procurar siempre que sean issues del tipo
minor o normal para facilitar las cosas.

16. ▸ Una de las acciones más sencillas puede ser
hacer un reroll.
▸ Qué es exactamente hacer un reroll:
▹ El parche existente, aun estando bien,
resulta que por cambios en otros issues, ha
afectado a la issue actual.
▹ Por tanto el parche no se puede utilizar y
necesita reajustarse para su uso.
▹ https://www.drupal.org/patch/reroll
▹ No necesita cambios, solo adaptarse para
que el parche pueda aplicarse.
Novice - reroll

17. ▸ Podemos encontrar issues de ese tipo aquí:
▹ https://www.drupal.org/project/issues/sear
ch/drupal?project_issue_followers=&issue
_tags_op=%3D&issue_tags=Needs+reroll
Nota: Procurar siempre que sean issues del tipo
minor o normal para facilitar las cosas.
Novice - reroll

18. ▸ La issue no existe. Buscad bien.
▸ Coger una plantilla existente para rellenar la
información y publicar el parche que consideres
oportuno poniéndolo en need review.
▸ A partir de ahí, es cuando empieza la comunidad
a intervenir.
▸ Si tienes cualquier cuestión no dudes en
preguntar.
▸ Aquí podemos encontrar dichas plantillas:
▹ https://www.drupal.org/issue-summaries
Creación de issues

19. ▸ En cualquier caso podemos utilizar las issues
existentes.
Recordad: Procurar siempre que sean issues del
tipo minor o normal para facilitar las cosas.
Issues genéricas

20. ▸ Otro lugar para poder comenzar son los módulos
contrib, aunque no siempre resulta sencillo por
varios motivos.
▹ No sabes que deberia de hacer exactamente.
▹ No lo has hecho tú, aunque si es
medianamente drupalero no deberías tener
problemas.
Contrib

21. De cualquier manera, siempre hay tareas sencillas
para poder hacer:
▸ Añadir rutas de configuración.
▸ Añadir composer.json.
▸ …
Usad siempre el git del módulo para ver cómo
aplicar los cambios y crear los parches.
Contrib

22. ▸ Suele más accesible contactar con alguien que
lleve un módulo que alguien del core.
▹ Facilita mucho el tener feedback.
▹ O comprender mejor la necesidad de la
incidencia.
▸ Tendemos a solucionarlo solo para nuestros
casos. ERROR.
▸ NO SEAS PEREZOSO y comparte ese parche con
la comunidad, es bueno para ti, para ellos y para
el resto de la comunidad.
Contrib

23. ▸ Aquí está el listado de las personas que son las
encargadas de mantener cada
componente/módulo/tema:
▹ https://api.drupal.org/api/drupal/core!MAIN
TAINERS.txt/8
Maintainers

24. Crear nuestros propios módulos y contribuir a la
comunidad.
▸ Que no exista el módulo.
▹ Sino hace lo mismo, comenzar el proceso.
▹ Mejor colaborar que competir.
▸ Si existe, crear nuevas features para el módulo
que exista.
▸ Asegúrese de que su aplicación contiene un
enlace de repositorio (sandbox) y proyecto.
Project Application

25. Crear nuestros propios módulos y contribuir a la
comunidad.
▸ Cualquiera puede crear su módulo
▸ Pero!!!!!
▹ Que no exista el módulo.
▹ Sino hace lo mismo, comenzar el proceso.
▹ Mejor colaborar que competir.
▹ Si existe, crear nuevas features para el módulo
que exista.
▹ Asegúrese de que su aplicación contiene un
enlace de repositorio y proyecto.
Drupal.org security advisory
coverage applications

26. ▸ Pero mi módulo sólo está en amarillo.
Drupal.org security advisory
coverage applications

27. ▸ Quiero ponerlo en verde!!!
Drupal.org security advisory
coverage applications

28. ▸ Antes
▸ Después
Drupal.org security advisory
coverage applications

29. Estas son lecturas casi obligadas si deseas construir tu
propio módulo/theme.
▸ Project application checklist
▸ Review process for Full Project Applications
▸ Apply for permission to create full projects (no
necesario)
▸ https://www.drupal.org/project/projectapplications
▸ PAReview.sh (recomendado - revisar codigo)
▹ PAReview.sh (vía web)
▸ Coder
▸ Review bonus (acelerar el proceso - obligatorio)
Drupal.org security advisory
coverage applications

30. La recomendación más importante que te
puedo dar es que busques a un mentor
que te ayude.
Drupal.org security advisory
coverage applications

31. Recursos

32. ▸ Aquí está el listado de las personas que son las
encargadas de mantener cada
componente/modulo/tema:
▹ https://api.drupal.org/api/drupal/core!MAIN
TAINERS.txt/8
Recursos - Maintainers

33. ▸ https://www.drupal.org/novice
▸ https://www.drupal.org/irc
▸ https://www.drupal.org/contribute/development
▸ https://www.drupal.org/coding-standards
▸ http://2014.drupalday.es/sesion/publica-tu-proyect
o-en-drupalorg.html
▹ Video: https://vimeo.com/113362254
▹ Slides:
http://2014.drupalday.es/sites/default/files/pu
blica_tu_proyecto_en_drupal.org_.pdf
▸ http://blog.worldempire.ch/story/how-contribute-d
rupal
Recursos - Antes de empezar

34. ▸ https://www.drupal.org/contribute/core
▸ Make patch
▸ Advanced patch contributor guide
▸ https://www.drupal.org/patch/apply
▸ https://www.drupal.org/documentation/git/interdi
ff
Recursos - Drupal Core

35. ▸ Novice:
▹ https://www.drupal.org/novice
▹ https://www.drupal.org/project/issues/search/
drupal?project_issue_followers=&issue_tags
_op=%3D&issue_tags=Novice
▸ Reroll:
▹ https://www.drupal.org/patch/reroll
▹ https://www.drupal.org/project/issues/search/
drupal?project_issue_followers=&issue_tags
_op=%3D&issue_tags=Needs+reroll
Recursos - Drupal Core

36. ▸ https://www.drupal.org/issue-queue
▸ https://www.drupal.org/issue-queue/status
▸ Attribute this contribution
▸ Templates for issue status transitions
▸ Issue submission form fields
▸ https://www.drupal.org/issue-summaries
(plantillas para las issues)
▸ Dreditor (plugin Chrome)
▸ https://www.drupal.org/sprint-task-cards
▹ Spanish Task Cards
Recursos - Drupal Core

37. ▸ Project application checklist
▸ Review process for Full Project Applications
▸ Apply for permission to create full projects
▸ https://www.drupal.org/project/projectapplications
▸ PAReview.sh (recomendado - revisar codigo)
▹ PAReview.sh (vía web)
▸ Coder
▸ Review bonus (acelerar el proceso - obligatorio)
Recursos - Project Application

40. Biko2
www.biko2.com
+34.91.436.48.54
info@biko2.com
Ruben Egiguren (keopx)