Skip to content

Latest commit

 

History

History
138 lines (88 loc) · 5.69 KB

CONTRIBUTING.md

File metadata and controls

138 lines (88 loc) · 5.69 KB

Contribuir a Roo Code

Roo Code es un proyecto impulsado por la comunidad, y valoramos profundamente cada contribución. Para agilizar la colaboración, operamos con un enfoque Issue-First, lo que significa que todos los Pull Requests (PRs) deben estar vinculados primero a un Issue de GitHub. Por favor, revisa esta guía cuidadosamente.

Tabla de Contenidos

Antes de Contribuir

1. Código de Conducta

Todos los colaboradores deben adherirse a nuestro Código de Conducta.

2. Hoja de Ruta del Proyecto

Nuestra hoja de ruta guía la dirección del proyecto. Alinea tus contribuciones con estos objetivos clave:

Confiabilidad Primero

  • Garantizar que la edición de diferencias y la ejecución de comandos sean consistentemente confiables.
  • Reducir los puntos de fricción que disuaden el uso regular.
  • Garantizar un funcionamiento fluido en todos los idiomas y plataformas.
  • Ampliar el soporte sólido para una amplia variedad de proveedores y modelos de IA.

Experiencia de Usuario Mejorada

  • Simplificar la interfaz de usuario para mayor claridad e intuitividad.
  • Mejorar continuamente el flujo de trabajo para satisfacer las altas expectativas que los desarrolladores tienen para herramientas de uso diario.

Liderazgo en Rendimiento de Agentes

  • Establecer evaluaciones comparativas completas (evals) para medir la productividad en el mundo real.
  • Facilitar que todos puedan ejecutar e interpretar estas evaluaciones fácilmente.
  • Ofrecer mejoras que demuestren aumentos claros en las puntuaciones de evaluación.

Menciona la alineación con estas áreas en tus PRs.

3. Únete a la Comunidad Roo Code

  • Principal: Únete a nuestro Discord y envía un DM a Hannes Rudolph (hrudolph).
  • Alternativa: Los colaboradores experimentados pueden participar directamente a través de GitHub Projects.

Encontrar y Planificar tu Contribución

Tipos de Contribuciones

  • Corrección de errores: Solucionar problemas en el código.
  • Nuevas funciones: Añadir funcionalidades.
  • Documentación: Mejorar guías y claridad.

Enfoque Issue-First

Todas las contribuciones deben comenzar con un Issue de GitHub.

  • Revisar issues existentes: Busca en GitHub Issues.
  • Crear un issue: Usa las plantillas apropiadas:
    • Errores: Plantilla "Bug Report".
    • Funciones: Plantilla "Detailed Feature Proposal". Se requiere aprobación antes de comenzar.
  • Reclamar issues: Comenta y espera la asignación oficial.

Los PRs sin issues aprobados pueden ser cerrados.

Decidir en Qué Trabajar

Reportar Errores

Proceso de Desarrollo y Envío

Configuración de Desarrollo

  1. Fork & Clona:
git clone https://github.com/TU_USUARIO/Roo-Code.git
  1. Instalar Dependencias:
npm run install:all
  1. Depuración: Abre con VS Code (F5).

Guía para Escribir Código

  • Un PR enfocado por función o corrección.
  • Sigue las mejores prácticas de ESLint y TypeScript.
  • Escribe commits claros y descriptivos que referencien issues (ej., Fixes #123).
  • Proporciona pruebas exhaustivas (npm test).
  • Rebase sobre la última rama main antes de enviar.

Enviar un Pull Request

  • Comienza como PR en Borrador si buscas feedback temprano.
  • Describe claramente tus cambios siguiendo la Plantilla de Pull Request.
  • Proporciona capturas de pantalla/videos para cambios en la UI.
  • Indica si son necesarias actualizaciones de documentación.

Política de Pull Request

  • Debe referenciar issues preaprobados y asignados.
  • Los PRs que no cumplan con la política pueden ser cerrados.
  • Los PRs deben pasar las pruebas de CI, alinearse con la hoja de ruta y tener documentación clara.

Proceso de Revisión

  • Triage Diario: Revisiones rápidas por parte de los mantenedores.
  • Revisión Semanal en Profundidad: Evaluación integral.
  • Itera rápidamente basándote en el feedback.

Legal

Al contribuir, aceptas que tus contribuciones serán licenciadas bajo la Licencia Apache 2.0, consistente con la licencia de Roo Code.