Cómo contribuir a ownCloud: Guía para desarrolladores

Quién puede contribuir

Damos la bienvenida a las contribuciones de todos: desarrolladores, redactores de documentación, diseñadores, traductores, testers y cualquier persona que quiera ayudar a mejorar ownCloud. Ya sea corrigiendo un error tipográfico o creando una extensión web completa, esta guía te explica cómo puedes contribuir.

Licencias

Licencia objetivo para nuevos proyectos: Apache License 2.0

ownCloud está en proceso de transición a Apache 2.0 como licencia predeterminada para nuevos repositorios y componentes bajo el OSPO. Apache 2.0 es permisiva, ampliamente comprendida, compatible con la mayoría de los requisitos de adquisición de empresas y sector público, y ampliamente adoptada en el ecosistema open source.

Los repositorios heredados pueden mantener sus licencias actuales durante un periodo de transición:

Repositorio / Componente	Licencia actual	Plan de transición
oCIS	Apache 2.0	Ya utiliza la licencia objetivo
Cliente de escritorio	GPL v2	En evaluación
Cliente Android	GPL v2	En evaluación
Cliente iOS	GPL v3	En evaluación
Servidor ownCloud	AGPLv3	Fin de vida útil; no se planea cambiar la licencia

Los cambios de licencia para repositorios existentes se comunicarán con antelación y consulta a la comunidad. No cambiamos licencias de forma retroactiva en código ya publicado.

No se requiere CLA – Usamos DCO

ownCloud no requiere un Acuerdo de Licencia de Contribuidor (CLA). Anteriormente utilizábamos un CLA que incluía la cesión completa de derechos de autor a ownCloud GmbH. Ese CLA transfería todos tus derechos, títulos e intereses, incluyendo todos los derechos de autor, sobre tus contribuciones a ownCloud. Esta práctica ha sido retirada. Ya no se requiere para nuevas contribuciones a componentes licenciados bajo Apache 2.0.

En su lugar, utilizamos el Developer Certificate of Origin (DCO). El DCO es una declaración ligera por cada commit en la que aseguras que tienes derecho a enviar el código bajo la licencia del proyecto. No transfiere derechos de autor a ownCloud GmbH. Tú mantienes la propiedad total de tus contribuciones, en el sentido de la licencia Apache 2.0.

Para firmar un commit, añade una línea Signed-off-by:

git commit -s -m "Add photo metadata search support"

(Asegúrate de tener PGP habilitado: https://docs.github.com/articles/about-gpg)

Esto añade una línea como:

Signed-off-by: Tu Nombre <tu@email.com>

El texto del DCO (disponible en developercertificate.org) confirma que:

Escribiste la contribución o tienes derecho a enviarla.
La envías bajo la licencia del proyecto.
Entiendes que la contribución es pública y que se mantiene un registro.

Para quienes firmaron el antiguo CLA: tus contribuciones existentes siguen siendo válidas. No necesitas hacer nada más. Las nuevas contribuciones solo requieren la firma DCO.

Para contribuyentes corporativos: si tu empresa tiene políticas de propiedad intelectual, asegúrate de tener permiso para contribuir bajo el DCO. Muchas organizaciones tienen políticas generales para contribuciones open source. Si la tuya no, la naturaleza por commit del DCO facilita obtener aprobación específica en vez de un CLA general.

Cómo contribuir

Encuentra algo en lo que trabajar. Explora los issues etiquetados como “good-first-issue” en nuestros repositorios. Consulta la hoja de ruta del proyecto y los RFC abiertos para iniciativas más grandes. Si tienes una idea, abre primero un issue para debatirla antes de invertir mucho esfuerzo.
Haz un fork y crea una rama. Haz fork del repositorio relevante y crea una rama de funcionalidad. Los nombres de las ramas deben ser descriptivos: feat/photo-metadata-search, fix/ocm-federation-timeout, docs/improve-deployment-guide.
Desarrolla. Sigue las convenciones de codificación del repositorio (las reglas de linting específicas del lenguaje se aplican en CI). Escribe pruebas para la nueva funcionalidad. Documenta nuevas funciones, opciones de configuración y APIs. Si usas desarrollo asistido por IA, sigue nuestra Política de Contribución Asistida por IA: informa, comprende, prueba y documenta.
Haz commits con firma DCO. Cada commit debe incluir una línea Signed-off-by. Los commits sin firma DCO serán marcados por nuestros checks de CI y no podrán fusionarse.
Envía un pull request. Escribe una descripción clara del PR: qué cambia, por qué y cómo debe probarse. Haz referencia a issues relacionados. Incluye capturas de pantalla para cambios en la interfaz. Responde a los comentarios de revisión.
Revisión y merge. Los mantenedores revisarán tu PR para verificar corrección, calidad de código, cobertura de pruebas, documentación y adecuación arquitectónica. Puede requerir varias rondas, es normal. Los PR que pasan la revisión son fusionados por un mantenedor.

Tipos de contribuciones

El código es la forma más visible de contribuir, pero no la única. Valoramos y reconocemos:

Documentación: guías, documentación de API, instrucciones de implementación, traducciones.
Pruebas: informes de errores con pasos para reproducirlos, contribuciones de casos de prueba, pruebas exploratorias.
Diseño: feedback de UX, wireframes, mejoras de accesibilidad.
Comunidad: responder preguntas en foros, mentoría a nuevos contribuidores, organización de eventos.
Difusión: artículos de blog, charlas en conferencias, casos de éxito.

Código de conducta

Esperamos que todos los contribuidores sigan nuestro Código de Conducta. Estamos comprometidos con un entorno acogedor, respetuoso e inclusivo.

Las violaciones o inquietudes pueden reportarse a coc@owncloud.com.

Canales de comunicación

Issues y PRs en GitHub: canal principal para discusiones técnicas.
Documentación: doc.owncloud.com
Foros de la comunidad: central.owncloud.org
Contacto OSPO: ospo@kiteworks.com

Reconocimiento

Gráficas de contribución y notas de lanzamiento en GitHub.
Salón de la fama de seguridad para quienes reportan vulnerabilidades.
Reconocimientos comunitarios e invitaciones a eventos.
Vías de contribución: los contribuidores activos pueden ser invitados a ser revisores, mantenedores o miembros del consejo asesor.

Preguntas frecuentes

Cualquier persona puede contribuir a ownCloud, incluidos desarrolladores, redactores de documentación, diseñadores, traductores, testers y cualquiera que quiera ayudar a mejorar la plataforma. Las contribuciones pueden ir desde corregir errores tipográficos hasta crear extensiones web completas.

ownCloud está migrando a la licencia Apache 2.0 como licencia predeterminada para nuevos proyectos y componentes. Esta licencia es permisiva, ampliamente adoptada y compatible con la mayoría de los requisitos de adquisición empresarial y del sector público.

No, ownCloud ya no exige un CLA. En su lugar, utiliza el Developer Certificate of Origin (DCO), una certificación ligera por cada commit que confirma que tienes derecho a enviar código bajo la licencia del proyecto sin transferir derechos de autor.

Además de programar, puedes contribuir a ownCloud con documentación (guías, documentación de API, traducciones), pruebas (informes de errores, casos de prueba), diseño (feedback de experiencia de usuario, mejoras de accesibilidad), soporte a la comunidad (mentoría, responder preguntas) y difusión (artículos de blog, charlas).