Skip to content

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 desempenho
  • oxc_linter: motor de lint rápido com 650+ regras
  • oxc_transformer: transformação TypeScript e JSX
  • oxc_minifier: minificação JavaScript (em desenvolvimento)
  • oxc_formatter: formatação de código compatível com Prettier

Sua primeira contribuição

  1. Navegue issues: procure good first issue
  2. Pergunte: peça esclarecimentos no Discord ou no GitHub
  3. Comece pequeno: documentação ou correções simples
  4. 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

Mal podemos esperar para ver o que você vai construir com a gente! 🚀