Contribuir al proyecto de código abierto OTOBO

Contribuir al proyecto de código abierto OTOBO

OTOBO es de código abierto bajo la organización de GitHub RotherOSS (https://github.com/RotherOSS/otobo). Si deseas reportar errores o contribuir con tu propio código, sigue este flujo de trabajo:

---

1. Flujo de trabajo de GitHub

1.1 Fork & Clone

1. Crea un fork de https://github.com/RotherOSS/otobo.
2. Clona tu fork localmente:

   git clone https://github.com/<tu-usuario>/otobo.git
   cd otobo

1.2 Branching

Crea una nueva rama para cada cambio:

git checkout -b feature/<breve-descripcion>

Ejemplo:

git checkout -b feature/add-hello-world-module

1.3 Commit & Push

1. Implementa tu código.

2. Añade mensajes de commit significativos:

   git add .
   git commit -m "Adds HelloWorld module with basic functionality"

3. Envía (push) tu rama:

   git push origin feature/add-hello-world-module

1.4 Pull Request

1. Abre tu fork en GitHub.
2. Haz clic en Compare & pull request.
3. Describe brevemente en el texto del PR qué hace tu funcionalidad/corrección de errores y por qué es importante.
4. Selecciona la rama de destino correcta (normalmente master o development).

---

2. Estilo de código y pruebas

2.1 CodePolicy

RotherOSS utiliza la herramienta CodePolicy (https://github.com/RotherOSS/CodePolicy) para verificar los estándares de codificación.

• Instalación:

  cpanm CodePolicy

• Ejecución en la raíz del repositorio:

  CodePolicy --check .

2.2 Módulos Perl y POD

• Cada módulo Kernel::System::* y Kernel::Modules::* debe contener documentación POD.
• Declara las dependencias en our @ObjectDependencies.
• Asegúrate de usar use strict; use warnings;.

2.3 Pruebas unitarias

OTOBO utiliza pruebas de Mojolicious y [Test::More]. Coloca tus pruebas en t/:

prove -l t/MyModule.t

---

3. Gestión de Issues y revisiones

3.1 Abrir Issues

• Primero, busca si ya existen issues similares.
• Crea un issue con título, pasos de reproducción, logs y capturas de pantalla (si es necesario).

3.2 Etiquetas y plantillas

• Utiliza las etiquetas bug, enhancement, question.
• Sigue las plantillas de issues y PR en el repositorio.

3.3 Code Reviews

• Responde puntualmente a los comentarios de revisión en el PR.
• Añade pruebas o cambia el estilo si los revisores lo sugieren.
• Tras la aprobación, tu PR será fusionado (merged).

---

4. Comunidad y soporte

• GitHub Discussions: https://github.com/RotherOSS/otobo/discussions
• Lista de correo y chat: Encontrarás los enlaces en https://otobo.com/ en la sección “Community”.
• Documentación: Documentación para desarrolladores en https://doc.otobo.org/ (“How to Contribute”).

¡Mucho éxito contribuyendo a OTOBO!