Nuove linee guida per i contributi

Se sei arrivato qui da una Issue/PR chiusa automaticamente, niente panico e non sentirti rifiutato. Nella maggior parte dei casi, il lavoro che hai fatto finirà comunque per essere integrato in Exercism, oppure il tuo problema verrà risolto. Accogliamo e incoraggiamo i contributi, ma preferiamo discutere le cose sul nostro forum prima di buttarci nel codice su GitHub. Aprire un thread sul forum farà progredire le cose.

Nell'ultimo anno abbiamo sperimentato la limitazione dei contributi da parte di chi non è maintainer, per liberare tempo ai nostri contributori principali e permettere loro di apportare miglioramenti più significativi alle tracce. Ha funzionato piuttosto bene. Rispetto al 2022, nel 2023 abbiamo visto il doppio dei nuovi esercizi aggiunti e il triplo dei sillabi creati. Il cambio di metodologia ha reso possibili contributi molto più ampi, meno frustrazione e meno distrazioni per i nostri contributori principali.

Tuttavia, sono anche consapevole che ha creato frustrazioni nei nuovi contributori, che sono motivati ad aiutare ma si sentono bloccati dal nostro processo di contribuzione. Quindi oggi voglio proporre alcune linee guida nuove (o più chiare) su come porteremo avanti i contributi nei prossimi mesi.

La regola fondamentale da capire è che discutiamo idee, bug e problemi sul nostro forum e che discutiamo le conseguenti modifiche al codice su GitHub (nelle revisioni delle PR). La regola secondaria è che (fatta eccezione per i maintainer autonomi) discutiamo le cose prima di metterle in pratica. Il nostro forum permette a contributori e maintainer di tracce diverse di condividere conoscenze e saggezza su un'ampia gamma di linguaggi e idee, senza doversi iscrivere a 300 repository diverse su GitHub e ritrovarsi con le notifiche intasate.

Linee guida aggiornate

Ottenere supporto

• Se ti blocchi su qualcosa prima di risolvere un esercizio (ad esempio installare la CLI, eseguire i test, oppure la logica o i requisiti di un esercizio), i nostri canali di supporto sono la categoria "Exercism Support" sul forum e il canale #get-help sul nostro server Discord.
• Non usiamo GitHub né l'email per le richieste di supporto.
• Se hai risolto un esercizio ma hai domande al riguardo, dovresti richiedere il mentoring direttamente su Exercism.

Segnalare bug e problemi

• Tutti i bug e i problemi vanno aperti sul nostro forum, dove un'ampia gamma di persone può contribuire a capire e risolvere il problema.
  • Se il problema riguarda un linguaggio, usa la categoria Programming/xxx corrispondente.
  • Se si tratta di un bug del sito web, usa la categoria "Bugs & Feature Requests".
• Le issue su GitHub verranno in genere chiuse automaticamente e chi le ha aperte sarà reindirizzato al forum (con un link a un solo clic per copiare e incollare la propria issue, come avviene già oggi).
• I maintainer delle tracce possono disattivare la chiusura automatica delle issue, ma la via ufficiale resta comunque il forum.

Aprire Pull Request

• Le Pull Request vanno discusse sul forum prima di mettersi al lavoro.
• Le Pull Request di chi non fa parte dell'organizzazione continueranno a essere chiuse automaticamente, ma verranno spesso riaperte una volta che il lavoro è stato discusso sul forum. Se l'idea alla base di una PR è già stata approvata, ti basta aggiungere un link alla PR nel thread corrispondente sul forum e la riapriremo.
• I maintainer delle tracce possono disattivare la chiusura automatica delle PR, ma consigliamo comunque di discutere prima tutte le PR sul forum.

Riepilogo

La nostra prima priorità resta proteggere il tempo e le energie mentali dei nostri contributori principali, senza i quali Exercism non può funzionare. Ma vogliamo anche assicurarci che Exercism resti un posto dove le nuove persone possono partecipare senza barriere troppo proibitive, e dove possiamo incoraggiare e sostenere queste persone perché diventino a loro volta contributori principali!

Non vedo l'ora di scoprire come questi cambiamenti influenzeranno i contributi nei prossimi mesi. Faremo il punto di nuovo a metà del 2024.