mirror of
https://github.com/RooVetGit/Roo-Code.git
synced 2026-09-06 08:18:39 +00:00
112 lines
5.6 KiB
Markdown
112 lines
5.6 KiB
Markdown
# Contribuir a Roo Code
|
|
|
|
Estamos encantados de que estés interesado en contribuir a Roo Code. Ya sea que estés arreglando un error, añadiendo una función o mejorando nuestra documentación, ¡cada contribución hace que Roo Code sea más inteligente! Para mantener nuestra comunidad vibrante y acogedora, todos los miembros deben adherirse a nuestro [Código de Conducta](CODE_OF_CONDUCT.md).
|
|
|
|
## Únete a nuestra comunidad
|
|
|
|
¡Animamos encarecidamente a todos los colaboradores a unirse a nuestra [comunidad de Discord](https://discord.gg/roocode)! Formar parte de nuestro servidor de Discord te ayuda a:
|
|
|
|
- Obtener ayuda y orientación en tiempo real para tus contribuciones
|
|
- Conectar con otros colaboradores y miembros del equipo principal
|
|
- Mantenerte actualizado sobre los desarrollos y prioridades del proyecto
|
|
- Participar en discusiones que dan forma al futuro de Roo Code
|
|
- Encontrar oportunidades de colaboración con otros desarrolladores
|
|
|
|
## Reportar errores o problemas
|
|
|
|
¡Los informes de errores ayudan a mejorar Roo Code para todos! Antes de crear un nuevo issue, por favor [busca entre los existentes](https://github.com/RooVetGit/Roo-Code/issues) para evitar duplicados. Cuando estés listo para reportar un error, dirígete a nuestra [página de issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose) donde encontrarás una plantilla para ayudarte a completar la información relevante.
|
|
|
|
<blockquote class='warning-note'>
|
|
🔐 <b>Importante:</b> Si descubres una vulnerabilidad de seguridad, por favor utiliza la <a href="https://github.com/RooVetGit/Roo-Code/security/advisories/new">herramienta de seguridad de GitHub para reportarla de forma privada</a>.
|
|
</blockquote>
|
|
|
|
## Decidir en qué trabajar
|
|
|
|
¿Buscas una buena primera contribución? Revisa los issues en la sección "Issue [Unassigned]" de nuestro [Proyecto GitHub de Roo Code](https://github.com/orgs/RooVetGit/projects/1). ¡Estos están específicamente seleccionados para nuevos colaboradores y áreas donde nos encantaría recibir ayuda!
|
|
|
|
¡También damos la bienvenida a contribuciones a nuestra [documentación](https://docs.roocode.com/)! Ya sea arreglando errores tipográficos, mejorando guías existentes o creando nuevo contenido educativo - nos encantaría construir un repositorio de recursos impulsado por la comunidad que ayude a todos a sacar el máximo provecho de Roo Code. Puedes hacer clic en "Edit this page" en cualquier página para llegar rápidamente al lugar correcto en Github para editar el archivo, o puedes ir directamente a https://github.com/RooVetGit/Roo-Code-Docs.
|
|
|
|
Si estás planeando trabajar en una función más grande, por favor crea una [solicitud de función](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop) primero para que podamos discutir si se alinea con la visión de Roo Code.
|
|
|
|
## Configuración de desarrollo
|
|
|
|
1. **Clona** el repositorio:
|
|
|
|
```sh
|
|
git clone https://github.com/RooVetGit/Roo-Code.git
|
|
```
|
|
|
|
2. **Instala dependencias**:
|
|
|
|
```sh
|
|
npm run install:all
|
|
```
|
|
|
|
3. **Inicia la vista web (aplicación Vite/React con HMR)**:
|
|
|
|
```sh
|
|
npm run dev
|
|
```
|
|
|
|
4. **Depuración**:
|
|
Presiona `F5` (o **Ejecutar** → **Iniciar depuración**) en VSCode para abrir una nueva sesión con Roo Code cargado.
|
|
|
|
Los cambios en la vista web aparecerán inmediatamente. Los cambios en la extensión principal requerirán un reinicio del host de extensión.
|
|
|
|
Alternativamente, puedes construir un archivo .vsix e instalarlo directamente en VSCode:
|
|
|
|
```sh
|
|
npm run build
|
|
```
|
|
|
|
Un archivo `.vsix` aparecerá en el directorio `bin/` que puede ser instalado con:
|
|
|
|
```sh
|
|
code --install-extension bin/roo-cline-<version>.vsix
|
|
```
|
|
|
|
## Escribir y enviar código
|
|
|
|
Cualquiera puede contribuir con código a Roo Code, pero te pedimos que sigas estas pautas para asegurar que tus contribuciones puedan integrarse sin problemas:
|
|
|
|
1. **Mantén los Pull Requests enfocados**
|
|
|
|
- Limita los PRs a una sola función o corrección de errores
|
|
- Divide los cambios más grandes en PRs más pequeños y relacionados
|
|
- Separa los cambios en commits lógicos que puedan revisarse independientemente
|
|
|
|
2. **Calidad del código**
|
|
|
|
- Todos los PRs deben pasar las comprobaciones de CI que incluyen tanto linting como formateo
|
|
- Soluciona cualquier advertencia o error de ESLint antes de enviar
|
|
- Responde a todos los comentarios de Ellipsis, nuestra herramienta automatizada de revisión de código
|
|
- Sigue las mejores prácticas de TypeScript y mantén la seguridad de tipos
|
|
|
|
3. **Pruebas**
|
|
|
|
- Añade pruebas para nuevas funciones
|
|
- Ejecuta `npm test` para asegurar que todas las pruebas pasen
|
|
- Actualiza las pruebas existentes si tus cambios les afectan
|
|
- Incluye tanto pruebas unitarias como de integración cuando sea apropiado
|
|
|
|
4. **Directrices para commits**
|
|
|
|
- Escribe mensajes de commit claros y descriptivos
|
|
- Haz referencia a los issues relevantes en los commits usando #número-de-issue
|
|
|
|
5. **Antes de enviar**
|
|
|
|
- Haz rebase de tu rama sobre la última main
|
|
- Asegúrate de que tu rama se construye correctamente
|
|
- Comprueba que todas las pruebas están pasando
|
|
- Revisa tus cambios para detectar código de depuración o logs de consola
|
|
|
|
6. **Descripción del Pull Request**
|
|
- Describe claramente lo que hacen tus cambios
|
|
- Incluye pasos para probar los cambios
|
|
- Enumera cualquier cambio que rompa la compatibilidad
|
|
- Añade capturas de pantalla para cambios en la interfaz de usuario
|
|
|
|
## Acuerdo de contribución
|
|
|
|
Al enviar un pull request, aceptas que tus contribuciones serán licenciadas bajo la misma licencia que el proyecto ([Apache 2.0](../LICENSE)).
|