Novas diretrizes de contribuição

Se você foi direcionado aqui por uma Issue/PR fechada automaticamente, não entre em pânico nem leve para o lado pessoal. Na maioria das vezes, o trabalho que você fez vai acabar sendo integrado ao Exercism, ou o seu problema vai ser resolvido. Nós recebemos e incentivamos contribuições, mas gostamos de discutir as coisas no nosso fórum antes de partir para o código no GitHub. Abrir um tópico no fórum faz as coisas andarem.

No último ano, temos experimentado limitar as contribuições de quem não é mantenedor, para liberar o tempo dos nossos contribuidores principais e permitir que eles façam melhorias mais significativas nas trilhas. Isso funcionou muito bem. Em comparação com 2022, durante 2023 vimos o dobro de novos exercícios adicionados e o triplo de syllabuses criados. A mudança de metodologia permitiu contribuições muito maiores, menos frustração e menos distração para os nossos contribuidores principais.

No entanto, também sei que isso gerou frustrações em novos contribuidores que estão dispostos a ajudar, mas se sentem bloqueados pelo nosso processo de contribuição. Então, hoje, quero apresentar algumas diretrizes novas (ou mais claras) sobre como vamos seguir com as contribuições nos próximos meses.

A regra fundamental para entender é que discutimos ideias, bugs e problemas no nosso fórum, e discutimos as mudanças de código resultantes no GitHub (nas revisões de PR). A regra secundária é que (com exceção dos mantenedores, que são autônomos) discutimos as coisas antes de fazê-las. Nosso fórum permite que contribuidores e mantenedores de diversas trilhas compartilhem conhecimentos e experiências sobre uma grande variedade de linguagens e ideias, sem precisar se inscrever em 300 repositórios diferentes no GitHub e sobrecarregar suas notificações.

Orientação atualizada

Como obter suporte

• Se você estiver travado em algo antes de resolver um exercício (por exemplo, instalar o CLI, rodar os testes, ou travado na lógica ou nos requisitos de um exercício), nossos canais de suporte são a categoria "Exercism Support" no fórum e o canal #get-help no nosso servidor do Discord.
• Não usamos GitHub nem e-mail para pedidos de suporte.
• Se você já resolveu um exercício mas tem dúvidas sobre ele, peça mentoria no próprio Exercism.

Como reportar bugs e problemas

• Todos os bugs e problemas devem ser abertos no nosso fórum, onde várias pessoas podem ajudar a entender e resolver o problema.
  • Se o problema for relacionado a uma linguagem, use a categoria Programming/xxx correspondente.
  • Se for um bug no site, use a categoria "Bugs & Feature Requests".
• As issues do GitHub geralmente serão fechadas automaticamente, e quem as abriu será redirecionado ao fórum (com um link de um clique para copiar e colar o problema, como já acontece hoje).
• Os mantenedores de trilha podem optar por desativar o fechamento automático de issues, mas o caminho oficial continua sendo o fórum.

Como abrir Pull Requests

• Os Pull Requests devem ser discutidos no fórum antes de o trabalho ser feito.
• Pull Requests de pessoas que não são membros da organização continuarão sendo fechados automaticamente, mas muitas vezes serão reabertos depois que o trabalho for discutido no fórum. Se a ideia por trás de um PR já foi aprovada, basta adicionar um link para o PR no tópico correspondente do fórum que nós o reabriremos.
• Os mantenedores de trilha podem optar por desativar o fechamento automático de PRs, mas ainda recomendamos que todos os PRs sejam discutidos primeiro no fórum.

Resumo

Nossa primeira prioridade continua sendo proteger o tempo e a capacidade mental dos nossos contribuidores principais, sem os quais o Exercism não consegue funcionar. Mas também queremos garantir que o Exercism continue sendo um lugar onde pessoas novas possam se envolver sem barreiras proibitivas demais, e onde possamos incentivar e apoiar essas pessoas a também se tornarem contribuidoras principais!

Estou muito animado para ver como essas mudanças vão afetar as contribuições nos próximos meses. Vamos revisar tudo de novo em meados de 2024.