Contribuindo para o Roo Code

Estamos entusiasmados por você estar interessado em contribuir para o Roo Code. Seja corrigindo um bug, adicionando um recurso ou melhorando nossa documentação, cada contribuição torna o Roo Code mais inteligente! Para manter nossa comunidade vibrante e acolhedora, todos os membros devem aderir ao nosso Código de Conduta.

Junte-se à Nossa Comunidade

Incentivamos fortemente todos os colaboradores a se juntarem à nossa comunidade no Discord! Fazer parte do nosso servidor Discord ajuda você a:

Obter ajuda e orientação em tempo real sobre suas contribuições
Conectar-se com outros colaboradores e membros da equipe principal
Manter-se atualizado sobre os desenvolvimentos e prioridades do projeto
Participar de discussões que moldam o futuro do Roo Code
Encontrar oportunidades de colaboração com outros desenvolvedores

Relatando Bugs ou Problemas

Relatórios de bugs ajudam a tornar o Roo Code melhor para todos! Antes de criar uma nova issue, por favor pesquise as existentes para evitar duplicatas. Quando estiver pronto para relatar um bug, vá para nossa página de issues onde você encontrará um modelo para ajudá-lo a preencher as informações relevantes.

🔐 Importante: Se você descobrir uma vulnerabilidade de segurança, por favor use a ferramenta de segurança do Github para relatá-la de forma privada.

Decidindo no que Trabalhar

Procurando uma boa primeira contribuição? Verifique as issues na seção "Issue [Unassigned]" do nosso Projeto Github Roo Code. Estas são especialmente selecionadas para novos colaboradores e áreas onde gostaríamos de ter alguma ajuda!

Também damos as boas-vindas a contribuições para nossa documentação! Seja corrigindo erros de digitação, melhorando guias existentes ou criando novo conteúdo educacional - adoraríamos construir um repositório de recursos impulsionado pela comunidade que ajude todos a obter o máximo do Roo Code. Você pode clicar em "Edit this page" em qualquer página para ir rapidamente ao local certo no Github para editar o arquivo, ou pode mergulhar diretamente em https://github.com/RooVetGit/Roo-Code-Docs.

Se você está planejando trabalhar em um recurso maior, por favor crie primeiro uma solicitação de recurso para que possamos discutir se está alinhado com a visão do Roo Code.

Configuração de Desenvolvimento

Clone o repositório:

git clone https://github.com/RooVetGit/Roo-Code.git

Instale as dependências:

npm run install:all

Inicie o webview (aplicativo Vite/React com HMR):

npm run dev

Depuração: Pressione F5 (ou Executar → Iniciar Depuração) no VSCode para abrir uma nova sessão com o Roo Code carregado.

Alterações no webview aparecerão imediatamente. Alterações na extensão principal exigirão a reinicialização do host da extensão.

Alternativamente, você pode construir um .vsix e instalá-lo diretamente no VSCode:

npm run build

Um arquivo .vsix aparecerá no diretório bin/ que pode ser instalado com:

code --install-extension bin/roo-cline-<version>.vsix

Escrevendo e Enviando Código

Qualquer pessoa pode contribuir com código para o Roo Code, mas pedimos que você siga estas diretrizes para garantir que suas contribuições possam ser integradas sem problemas:

Mantenha os Pull Requests Focados
- Limite os PRs a um único recurso ou correção de bug
- Divida mudanças maiores em PRs menores e relacionados
- Divida as mudanças em commits lógicos que possam ser revisados independentemente
Qualidade do Código
- Todos os PRs devem passar nas verificações de CI que incluem tanto linting quanto formatação
- Resolva quaisquer avisos ou erros do ESLint antes de enviar
- Responda a todos os feedbacks do Ellipsis, nossa ferramenta automatizada de revisão de código
- Siga as melhores práticas de TypeScript e mantenha a segurança de tipos
Testes
- Adicione testes para novos recursos
- Execute npm test para garantir que todos os testes passem
- Atualize os testes existentes se suas mudanças os afetarem
- Inclua tanto testes unitários quanto de integração quando apropriado
Diretrizes de Commit
- Escreva mensagens de commit claras e descritivas
- Referencie issues relevantes nos commits usando #número-da-issue
Antes de Enviar
- Faça rebase da sua branch na última main
- Certifique-se de que sua branch é construída com sucesso
- Verifique novamente se todos os testes estão passando
- Revise suas mudanças para qualquer código de depuração ou logs de console
Descrição do Pull Request
- Descreva claramente o que suas mudanças fazem
- Inclua passos para testar as mudanças
- Liste quaisquer mudanças significativas
- Adicione capturas de tela para mudanças na UI

Acordo de Contribuição

Ao enviar um pull request, você concorda que suas contribuições serão licenciadas sob a mesma licença do projeto (Apache 2.0).

5.5 KiB Raw Permalink Blame History