Wiki

• FrontPage
• RecentChanges
• FindPage
• HelpContents
• Code

Esta página describe el proceso para contribuir código a cualquiera de los sub-proyectos de FreedomBox.

• Si no estás familiarizado con Git, el software de control distribuído de versiones, mirate un tutorial (en).

• Configura Git instalandolo y configurando tu nombre y correo electrónico.

• Clona el repositorio del proyecto. La URL del repositorio está publicada en las páginas de cada sub-proyecto: (FreedomBox y Freedom Maker).

  • Usar Salsa

    • Create una cuenta en Salsa si no la tienes ya.

    • Configura la autenticación de Salsa registrando tus claves SSH (en).

    • Bifurca (haz un Fork de) el repositorio del proyecto (en) en Salsa para crear tu repositorio personal.

    • Clona tu fork personal de Salsa a tu máquina local:

      • git clone git@salsa.debian.org:TU-USUARIO/NOMBRE-DE-TU-CLON.git

  • Sin Salsa

    • Clona el repositorio del proyecto.:

      • git clone https://salsa.debian.org/freedombox-team/NOMBRE-DEL-PROYECTO.git

• Crea una nueva rama para tu trabajo.

  • git branch RAMA-DE-TU-FUNCIONALIDAD

• Sigue las instrucciones del archivo HACKING para instalar el proyecto.

• Mira el Manual del Desarrollador de FreedomBox para encontrar un tutorial sobre cómo escribir apps para FreedomBox y documentación de referencia para la API.

• Implementa tu funcionalidad o tu arreglo de defecto.

• Haz tu código consistente con el código preexistente siguiendo los estándares de codificación y examinando el código preexistente. Si es un proyecto Python, siguiendo la guía de estilo PEP8 y ejecutando las herramientas flake8 y yapf sobre el código del proyecto. Mira el archivo HACKING del sub-proyecto para más detalles.

• Comprueba tus cambios y haz un commit con un buen mensaje de commit (en).

  • git add fichero1 fichero2

    git commit

• Envía tus cambios

  • Usando Salsa

    • Haz un push con tus cambios a Salsa:

      • git push origin RAMA-DE-TU-FUNCIONALIDAD

    • Visita la página del repositorio de Salsa y crea un merge request (en).

  • Sin Salsa

    • Crea parches para tus commits.

      • git format-patch master

    • Envía los parches a la lista de correo de !FreedomBox (freedombox-discuss@alioth-lists.debian.net). Opcionalmente usa el comando git send-email para esto.

• Generalmente otros desarrolladores responden con comentarios sobre cómo se podría mejorar tu trabajo. Haz cambios nuevos a tu trabajo haciendo más commits o rescribiendo los anteriores. Entonces, vuelve a enviarlos. (Este proceso podría llevar cierto tiempo dependiendo de la disponibilidad de otros desarrolladores y de la calidad de tus envíos. Así que no esperes, abre otra rama y trabaja en otra funcionalidad o en la corrección de otro defecto.)

• Cuando se estime que tu trabajo tiene la calidad suficiente y funcione bien, alguien mergeará tu trabajo a la rama master del repositorio del proyecto.

Recursos

• Documentación de Git (en).

• Ayuda del GitLab Salsa (en).

• Chuletario de Git (en).

• Comprendiendo el flujo de GitLab (en).

CategoryFreedomBox