mirror of
https://github.com/RooVetGit/Roo-Code.git
synced 2026-10-09 03:17:58 +00:00
112 lines
5.5 KiB
Markdown
112 lines
5.5 KiB
Markdown
# 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](CODE_OF_CONDUCT.md).
|
|
|
|
## Junte-se à Nossa Comunidade
|
|
|
|
Incentivamos fortemente todos os colaboradores a se juntarem à nossa [comunidade no Discord](https://discord.gg/roocode)! 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](https://github.com/RooVetGit/Roo-Code/issues) para evitar duplicatas. Quando estiver pronto para relatar um bug, vá para nossa [página de issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose) onde você encontrará um modelo para ajudá-lo a preencher as informações relevantes.
|
|
|
|
<blockquote class='warning-note'>
|
|
🔐 <b>Importante:</b> Se você descobrir uma vulnerabilidade de segurança, por favor use a <a href="https://github.com/RooVetGit/Roo-Code/security/advisories/new">ferramenta de segurança do Github para relatá-la de forma privada</a>.
|
|
</blockquote>
|
|
|
|
## Decidindo no que Trabalhar
|
|
|
|
Procurando uma boa primeira contribuição? Verifique as issues na seção "Issue [Unassigned]" do nosso [Projeto Github Roo Code](https://github.com/orgs/RooVetGit/projects/1). 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](https://docs.roocode.com/)! 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](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop) para que possamos discutir se está alinhado com a visão do Roo Code.
|
|
|
|
## Configuração de Desenvolvimento
|
|
|
|
1. **Clone** o repositório:
|
|
|
|
```sh
|
|
git clone https://github.com/RooVetGit/Roo-Code.git
|
|
```
|
|
|
|
2. **Instale as dependências**:
|
|
|
|
```sh
|
|
npm run install:all
|
|
```
|
|
|
|
3. **Inicie o webview (aplicativo Vite/React com HMR)**:
|
|
|
|
```sh
|
|
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:
|
|
|
|
```sh
|
|
npm run build
|
|
```
|
|
|
|
Um arquivo `.vsix` aparecerá no diretório `bin/` que pode ser instalado com:
|
|
|
|
```sh
|
|
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](../LICENSE)).
|