Post on 12-Jan-2017
Drupal Contribuir
Ruben Egiguren (keopx)25/10/2016
Me podeis encontrar en:
▸ Blog: www.keopx.net▸ Drupal: www.drupal.org/u/keopx▸ Twitter: @regiguren
Me llamoRuben Egiguren(keopx)
Introducción
IntroducciónObjetivo
▸ 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.
Por dónde empezarPrepararnos 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-drupal-contrib
▹ Acquia Dev Desktop▹ Otros.
Por dónde empezarPrepararnos 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.
Por dónde empezarAtribuciones
Por dónde empezarEstados de las issues
Templates for issue status transitions
Por dónde empezarPrepararnos 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.
Por dónde empezarMá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
Contribuir a Drupal
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
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/search/drupal?project_issue_followers=&issue_tags_op=%3D&issue_tags=Novice
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.
▸ 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
▸ 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
▸ 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
▸ 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
▸ 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
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
▸ 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
▸ 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
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
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
La recomendación más importante que te puedo dar es que busques a un mentor
que te ayude.
Project Application
Recursos
▸ 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
▸ 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/publica_tu_proyecto_en_drupal.org_.pdf
▸ http://blog.worldempire.ch/story/how-contribute-drupal
Recursos - Antes de empezar
▸ 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
▸ 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
▸ 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
▸ 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
Biko2
www.biko2.com
+34.91.436.48.54
info@biko2.com
Ruben Egiguren (keopx)