Roo-Code/locales/pt-BR/CONTRIBUTING.md

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. Você também pode verificar nosso Roteiro do Projeto abaixo para ver se sua ideia se encaixa em nossa direção estratégica.

Roteiro do Projeto

O Roo Code possui um roteiro de desenvolvimento claro que orienta nossas prioridades e direção futura. Entender nosso roteiro pode ajudar você a:

• Alinhar suas contribuições com os objetivos do projeto
• Identificar áreas onde sua expertise seria mais valiosa
• Entender o contexto por trás de certas decisões de design
• Encontrar inspiração para novos recursos que apoiem nossa visão

Nosso roteiro atual se concentra em seis pilares principais:

Suporte a Provedores

Nosso objetivo é oferecer suporte a tantos provedores quanto possível:

• Suporte mais versátil para "OpenAI Compatible"
• xAI, Microsoft Azure AI, Alibaba Cloud Qwen, IBM Watsonx, Together AI, DeepInfra, Fireworks AI, Cohere, Perplexity AI, FriendliAI, Replicate
• Suporte aprimorado para Ollama e LM Studio

Suporte a Modelos

Queremos que o Roo funcione bem em tantos modelos quanto possível, incluindo modelos locais:

• Suporte a modelos locais através de prompts de sistema personalizados e fluxos de trabalho
• Avaliações de benchmark e casos de teste

Suporte a Sistemas

Queremos que o Roo funcione bem no computador de todos:

• Integração de terminal multiplataforma
• Suporte forte e consistente para Mac, Windows e Linux

Documentação

Queremos documentação abrangente e acessível para todos os usuários e colaboradores:

• Guias de usuário e tutoriais expandidos
• Documentação clara da API
• Melhor orientação para colaboradores
• Recursos de documentação multilíngues
• Exemplos interativos e amostras de código

Estabilidade

Queremos diminuir significativamente o número de bugs e aumentar os testes automatizados:

• Interruptor de registro de depuração
• Botão de cópia "Informações de Máquina/Tarefa" para enviar com solicitações de suporte/bug

Internacionalização

Queremos que o Roo fale o idioma de todos:

• 我们希望 Roo Code 说每个人的语言
• Queremos que Roo Code hable el idioma de todos
• हम चाहते हैं कि Roo Code हर किसी की भाषा बोले
• نريد أن يتحدث Roo Code لغة الجميع

Damos especialmente as boas-vindas a contribuições que avançam os objetivos do nosso roteiro. Se você estiver trabalhando em algo que se alinha com esses pilares, por favor mencione isso na descrição do seu PR.

Configuração de Desenvolvimento

1. Clone o repositório:

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

2. Instale as dependências:

npm run install:all

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

npm run dev

4. 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:

1. 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

2. 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

3. 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

4. Diretrizes de Commit

   • Escreva mensagens de commit claras e descritivas
   • Referencie issues relevantes nos commits usando #número-da-issue

5. 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

6. 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).