XCoderXCoder.
Documentação

Contribuindo

Editar esta página

PRs, traduções, documentação e estilo de commits.

Obrigado por querer contribuir! O XCoder é um projeto de comunidade e toda forma de ajuda conta. Este guia resume o fluxo.

Formas de contribuir

  • Código — bugs, recursos, refatorações (veja Compilar do código-fonte para o ambiente).
  • Traduções — 31 idiomas; o português e o inglês são os arquivos-mestre.
  • Documentação — esta wiki, os docs do repositório e o site da comunidade.
  • Plugins — publique no marketplace e ajude outros autores.
  • Testes e bug reports — issues bem escritas valem ouro.

Fluxo de código (pull requests)

  1. Abra uma issue primeiro para bugs/feature não triviais — alinhamos o desenho antes do código.
  2. Faça um fork, crie uma branch descritiva: git checkout -b feat/minha-feature.
  3. Implemente com os padrões do projeto (o lint dita a formatação — não discuta tabs no PR 😄).
  4. Rode a tríade de qualidade antes do PR:
    npm run check && npm run typecheck && npm run test
  5. Abra o PR preenchendo o template (checklist bilíngue) e referencie a issue (Closes #123).

Os templates de bug report e feature request ficam em .github/ISSUE_TEMPLATE/ e o de PR em .github/PULL_REQUEST_TEMPLATE.md.

Traduções

O arquivo-mestre é src/lang/en-us.json; o português (pt-br.json) deve estar sempre 100%. Para traduzir/adicionar um idioma:

  1. Copie o en-us.json para o código do idioma (ex.: pt-pt.json).
  2. Traduza os valores — não renomeie chaves.
  3. Rode npm run lang:check para validar cobertura contra o mestre.
  4. Abra o PR — a varredura de traduções é automatizada, então traduções incompletas aparecem no relatório antes de a revisão humana entrar.

Chaves de comandos da paleta usam o prefixo cmd: e também fazem parte da varredura.

Documentação e wiki

Melhorias nesta wiki são PRs diretos: os fontes ficam em wiki/ no repositório e o mesmo conteúdo alimenta o site (xcoder-web). Correções de erro de português/inglês são aceitas na hora.

Estilo de commits

Padrão Conventional Commits: feat:, fix:, docs:, style:, refactor:, test:, chore: — exemplos reais do histórico: feat(plugins): own plugin marketplace — remote registry..., style(brand): correct icon layout....

Comunidade

  • Discussões, dúvidas e ideias: Discussões
  • Reporte bugs com o template em Issues
  • Conduta: seja gentil, seja claro, ajude quem está começando — foi assim que o software livre chegou até aqui.

Agradecimentos

O XCoder existe por cima de ombros de gigantes: o Acode da Foxdebug (base do fork), CodeMirror 6, o ecossistema Cordova, e todos os contribuidores e usuários que testam, traduzem e divulgam. Obrigado!