Novas diretrizes de contribuição

Se alguém te encaminhou para aqui a partir de uma Issue ou PR fechada automaticamente, não entres em pânico nem te sintas rejeitado. Na maioria dos casos, o trabalho que fizeste acaba por ser integrado no Exercism, ou o teu problema acaba por ser resolvido. Acolhemos e incentivamos as contribuições, mas gostamos de discutir as coisas no nosso fórum antes de saltar para o código no GitHub. Abrir um tópico no fórum faz as coisas avançarem.

No último ano, temos estado a experimentar limitar as contribuições de quem não é responsável pela manutenção, para libertar tempo aos nossos contribuidores principais e permitir-lhes fazer melhorias mais significativas nos percursos. Isto tem funcionado bastante bem. Em comparação com 2022, durante 2023 vimos o dobro de novos exercícios adicionados e o triplo de programas 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 tenho consciência de que criou frustrações em novos contribuidores que estão empenhados em ajudar, mas se sentem bloqueados pelo nosso processo de contribuição. Por isso, hoje quero apresentar algumas orientações novas (ou mais claras) para a forma como vamos avançar com as contribuições nos próximos meses.

A regra fundamental a perceber é que discutimos ideias, bugs e problemas no nosso fórum e discutimos as alterações daí resultantes ao código no GitHub (em revisões de PR). A regra secundária é que (com exceção dos responsáveis que são autónomos) discutimos as coisas antes de as fazer. O nosso fórum permite que contribuidores e responsáveis de vários percursos partilhem conhecimentos e sabedoria sobre uma grande variedade de linguagens e ideias, sem terem de subscrever 300 repositórios diferentes no GitHub e sobrecarregar as suas notificações.

Orientações atualizadas

Obter apoio

• Se tiveres dificuldades com alguma coisa antes de resolver um exercício (por exemplo, instalar a CLI, correr os testes ou perceber a lógica e os requisitos de um exercício), os nossos mecanismos de apoio são a categoria «Exercism Support» no fórum e o canal #get-help no nosso servidor do Discord.
• Não usamos o GitHub nem o email para pedidos de apoio.
• Se já resolveste um exercício mas tens dúvidas sobre ele, deves pedir mentoria no próprio Exercism.

Comunicar bugs e problemas

• Todos os bugs e problemas devem ser comunicados no nosso fórum, onde há muitas pessoas que podem ajudar a compreender e resolver o problema.
  • Se o problema estiver relacionado com uma linguagem, usa a categoria Programming/xxx correspondente.
  • Se for um bug no site, usa a categoria «Bugs & Feature Requests».
• As Issues do GitHub serão geralmente fechadas automaticamente e quem as abriu será encaminhado para o fórum (com um link de um clique para copiar e colar a respetiva Issue, como acontece atualmente).
• Os responsáveis pelos percursos podem optar por desativar o fecho automático de Issues, mas o caminho oficial continua a ser o fórum.

Abrir Pull Requests

• Os Pull Requests devem ser discutidos no fórum antes de o trabalho ser feito.
• Os Pull Requests de pessoas que não pertencem à organização continuarão a ser fechados automaticamente, mas serão muitas vezes reabertos depois de o trabalho ter sido discutido no fórum. Se a ideia por trás de um PR já tiver sido aprovada, basta adicionares um link para o PR no tópico correspondente do fórum e nós reabrimo-lo.
• Os responsáveis pelos percursos podem optar por desativar o fecho automático de PRs, mas continuamos a recomendar que todos os PRs sejam primeiro discutidos no fórum.

Resumo

A nossa prioridade continua a ser 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 continua a ser um lugar onde pessoas novas podem participar sem barreiras demasiado proibitivas, e onde podemos incentivar e apoiar essas pessoas a tornarem-se elas próprias contribuidores principais!

Estou entusiasmado por ver como estas mudanças vão afetar as contribuições que recebemos nos próximos meses. Vamos rever tudo novamente em meados de 2024.