Contribuir com o Oxc
Obrigado pelo interesse em contribuir com o Oxc! Estamos construindo a próxima geração de tooling JavaScript e adoraríamos sua ajuda.
Início rápido
O caminho mais rápido é pelas nossas good first issues: tarefas escolhidas para quem está começando.
Precisa de orientação? Entre no Discord; equipe e comunidade podem ajudar.
Formas de contribuir
Valorizamos qualquer tipo de contribuição:
🐛 Relatórios de bug
- Erros de parse ou comportamento incorreto do lint
- Problemas ou regressões de desempenho
- Casos extremos ainda não considerados
🚀 Desenvolvimento de recursos
- Novas regras de lint
- Melhor conformidade do parser
- Capacidades do transformer
- Novas ferramentas no ecossistema Oxc
📚 Documentação
- Melhorar guias de primeiros passos
- Exemplos e tutoriais
- Decisões de arquitetura
- Tradução para outros idiomas
🧪 Testes
- Casos de teste de codebases reais
- Cobertura de testes
- Benchmarks de desempenho
- Testes contra projetos do ecossistema
🔧 Infraestrutura
- Build e CI
- Ferramentas de desenvolvimento
- Otimização de trechos críticos
- Compatibilidade com outras ferramentas
Entendendo o codebase
O Oxc é organizado em vários crates:
oxc_parser: parser JavaScript/TypeScript de alto desempenhooxc_linter: motor de lint rápido com 650+ regrasoxc_transformer: transformação TypeScript e JSXoxc_minifier: minificação JavaScript (em desenvolvimento)oxc_formatter: formatação de código compatível com Prettier
Sua primeira contribuição
- Navegue issues: procure
good first issue - Pergunte: peça esclarecimentos no Discord ou no GitHub
- Comece pequeno: documentação ou correções simples
- Aprenda os padrões: estude o código existente
Comunidade
Canais
- GitHub Discussions: desenho e dúvidas
- Discord: chat em tempo real
- GitHub Issues: bugs e pedidos de recurso
- Twitter: siga @boshen_c
Código de conduta
Queremos um ambiente acolhedor e inclusivo. Leia o Código de Conduta antes de participar.
Uso de IA
Ao usar ferramentas de IA (LLMs, Copilot etc.) para contribuir com o Oxc:
- Divulgue o uso de IA para reduzir carga dos mantenedores
- Você é responsável por issues e PRs gerados com IA
- Conteúdo de baixa qualidade ou sem revisão será fechado na hora
- Contribuidores que enviarem repetidamente PRs de baixa qualidade (“slop”) poderão ser banidos sem aviso prévio. O ban pode ser revertido se você se comprometer a seguir esta política. Peça revisão no Discord.
Apoiamos IA como auxílio, mas toda contribuição deve ser revisada e testada por você. Código gerado por IA precisa ser entendido, validado e adaptado aos padrões do Oxc.
Próximos passos
- 📖 Saiba mais: Guia de desenvolvimento
- 🔍 Encontre uma issue: good first issues
- 💬 Comunidade: Discord
- 🛠️ Escolha uma área: parser, linter, transformer ou outras ferramentas
- ⚡️ Abra um PR: leia Regras e políticas de PR
Mal podemos esperar para ver o que você vai construir com a gente! 🚀