GGI Activity: Promover las mejores prácticas de desarrollo del código abierto


Table of contents


Promover las mejores prácticas de desarrollo del código abierto

ID de la Actividad: GGI-A-25.

Descripción

Esta actividad consiste en definir, promover y aplicar activamente las mejores prácticas de código abierto dentro de los equipos de desarrollo.

Como punto de partida se podría considerar atender los siguientes temas:

  • Documentación de usuario y desarrollador.
  • Organización adecuada del proyecto en un repositorio de acceso público.
  • Promover y aplicar la reutilización controlada.
  • Proporcionar una documentación completa y actualizada del producto.
  • Gestión de la configuración: flujos de trabajo git, patrones colaborativos.
  • Gestión de lanzamientos: liberación temprana y frecuente, versiones estables frente a versiones en desarrollo, etc.

Los proyectos de la OSS tienen un modus operandi especial que recuerda a un bazar. Para permitir y fomentar esta colaboración y mentalidad, se recomiendan algunas prácticas que faciliten el desarrollo colaborativo y descentralizado y las contribuciones de desarrolladores externos…

Documentos de la comunidad

Asegúrese de que todos los proyectos dentro de la empresa presenten los siguientes documentos:

  • README – descripción rápida del proyecto, cómo interactuar, enlaces a recursos.
  • Contributing – introducción para personas que desean contribuir.
  • Código de conducta – comportamiento considerado aceptable, o no, en la comunidad.
  • LICENSE – la licencia por omisión del repositorio.

REUSE – buenas prácticas para reutilizar

REUSE es una iniciativa de la Free Software Foundation Europe para mejorar la reutilización del software y simplificar el cumplimiento de las licencias.

Evaluación de oportunidades

Aunque depende en gran medida del conocimiento común del OSS entre el equipo, capacitar a las personas y crear procesos que hagan cumplir estas prácticas es siempre beneficioso. Es aún más importante cuando:

  • se desconocen los posibles usuarios y contribuyentes,
  • los desarrolladores no están acostumbrados al desarrollo de código abierto.

Evaluación del progreso

Los siguientes puntos de verificación demuestran el progreso en esta Actividad:

  • El proyecto establece una lista de buenas prácticas de código abierto que hay que cumplir.
  • El proyecto supervisa su adecuación a las buenas prácticas.
  • El equipo de desarrollo se ha concienciado para cumplir con las buenas prácticas de OSS.
  • Se evalúan periódicamente buenas prácticas nuevas y se procura aplicarlas.

Herramientas

Recomendaciones

  • La lista de buenas prácticas depende del contexto y dominio del programa y se debe revisar periódicamente al estilo de la mejora continua. Las prácticas deben vigilarse y evaluarse periódicamente para seguir el progreso.
  • Formar al personal en reutilización (como consumidores) del OSS y en ecosistemas (como contribuyentes).
  • Implementar REUSE.software como en la actividad #14.
  • Establecer un proceso para gestionar los riesgos jurídicos asociados con la reutilización y las contribuciones.
  • Alentar al personal a contribuir a proyectos externos.
  • Proporcione una plantilla o directrices oficiales para la estructura del proyecto.
  • Establezca comprobaciones automáticas para asegurarse de que todos los proyectos cumplen las directrices.

Recursos

Próximas actividades propuestas