Contribuir a Drupal
2 recomendaciones685 vistas
Este documento proporciona información y recursos para contribuir a Drupal. Explica cómo prepararse instalando el entorno LAMP y configurando las herramientas necesarias como un cliente IRC y un IDE con los estándares de codificación de Drupal. También describe dónde encontrar issues novatas y cómo realizar tareas como rerolls. Finalmente, incluye enlaces a documentación sobre cómo contribuir al núcleo de Drupal, crear módulos propios y aplicar para nuevos proyectos.
Contribuir a Drupal
- 2. Me podeis encontrar en: ▸ Blog: www.keopx.net ▸ Drupal: www.drupal.org/u/keopx ▸ Twitter: @regiguren Me llamo Ruben Egiguren (keopx)
- 3. Introducción
- 4. 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.
- 5. 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.
- 6. Por dónde empezar Prepararnos para el sprint Configura un cliente de IRC. ▸ https://www.drupal.org/irc ▹ Únete a los canales #drupal, #drupal-contribute, #drupal-es y relacionados. ▹ 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 Estados de las issues Templates for issue status transitions
- 9. 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.
- 10. 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. 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
- 13. 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
- 14. 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.
- 15. ▸ 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. Novice - reroll
- 16. ▸ 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
- 17. ▸ 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
- 18. ▸ 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
- 19. ▸ 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
- 20. 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
- 21. ▸ 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 para nuestros casos. ▸ NO SEAS PEREZOSO y comparte ese parche con la comunidad, es bueno para ti, para ellos y para el resto de la comunidad. Contrib
- 22. ▸ 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 Maintainers
- 23. 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
- 24. 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 ▸ https://www.drupal.org/project/projectapplications ▸ PAReview.sh (recomendado - revisar codigo) ▹ PAReview.sh (vía web) ▸ Coder ▸ Review bonus (acelerar el proceso - obligatorio) Project Application
- 25. La recomendación más importante que te puedo dar es que busques a un mentor que te ayude. Project Application
- 26. Recursos
- 27. ▸ 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
- 28. ▸ 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
- 29. ▸ 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
- 30. ▸ 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
- 31. ▸ 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) ▸ https://dreditor.org/ (plugin Chrome/Firefox) ▸ https://www.drupal.org/sprint-task-cards ▹ Spanish Task Cards Recursos - Drupal Core
- 32. ▸ 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