Modifiche in blocco ai pacchetti

Di tanto in tanto è necessario apportare modifiche a un gruppo di pacchetti. Quando le modifiche sono complesse o il numero di pacchetti interessati è elevato, il coordinamento è assolutamente indispensabile per evitare confusione e sprechi di energie. Potrebbe essere necessario segnalare un gran numero di bug, operazione che deve essere eseguita con attenzione. Questa pagina intende descrivere alcune misure da adottare quando sono necessarie modifiche su larga scala e illustrare la procedura per la segnalazione di bug in massa, qualora ciò si rendesse necessario.

Tutti sono molto impegnati e i responsabili della manutenzione dei pacchetti sono spesso volontari. Molti di loro ricevono inoltre un numero eccessivo di e-mail da Bugzilla, per cui spesso non gradiscono ricevere ulteriori segnalazioni di bug. Un piccolo sforzo in più all’inizio può rendere il processo più agevole per tutti, anche se ciò può richiedere un po' più di tempo. E spesso si può evitare di dover inviare una valanga di segnalazioni di bug.

Ottenere il consenso sui cambiamenti necessari

Per prima cosa dovresti inviare un messaggio alla mailing list Fedora devel e ottenere il consenso sulle modifiche che intendi apportare. Non importa quanto semplici o necessarie possano sembrare, potrebbero esserci modi migliori per fare le cose oppure la modifica potrebbe non essere necessaria per altri motivi. Parte di questa discussione dovrebbe riguardare lo sviluppo di una serie concisa di istruzioni che i responsabili dei pacchetti dovranno seguire per correggere i pacchetti interessati. Questo può ovviamente fare riferimento a documenti esterni, ma i responsabili dei pacchetti dovrebbero essere in grado di cogliere l’idea di base delle modifiche necessarie senza dover cercare i link.

Indicare i pacchetti che devono essere modificati

L’elenco dei pacchetti che richiederanno modifiche dovrebbe essere pubblicato sulla lista devel-announce non appena sarà stato definito. Per facilitare il più possibile il lavoro dei manutentori coinvolti, tale elenco dovrebbe presentarsi sotto forma di due elenchi: uno che riporti i pacchetti e i rispettivi proprietari, e l’altro che riporti i manutentori e i loro pacchetti. In questo modo, per un singolo manutentore sarà semplicissimo capire quanto lavoro ci sia da fare, mentre gli altri potranno farsi un’idea di chi potrebbe aver bisogno di aiuto. Per comodità, è disponibile un’utilità che genera questi elenchi a partire da un file contenente i nomi dei pacchetti, denominata “find-package-maintainers”.

Questi elenchi dovrebbero essere aggiornati man mano che la discussione procede e i pacchetti vengono corretti, e dovrebbero includere anche le istruzioni per la correzione dei pacchetti sopra menzionati.

Pulizia automatica

La pulizia automatizzata dei pacchetti è incoraggiata. Se è possibile apportare le modifiche necessarie in modo automatizzato con una bassa probabilità di effetti collaterali indesiderati, tale opzione dovrebbe essere almeno presa in considerazione, anche se applicabile solo a un sottoinsieme dei pacchetti interessati. I dettagli effettivi di questo processo (ad esempio se siano necessari i build o se le modifiche debbano essere semplicemente committate) dipendono quasi certamente dal tipo di modifiche coinvolte e dovrebbero essere definiti durante la discussione. I proven packagers possono eseguire la pulizia automatizzata senza ricorrere a pull request, effettuando il push direttamente nel sistema di controllo dei sorgenti.

"Testo dell’annuncio di revisione / del bug"

"Chiedi alla mailing list o a diversi manutentori interessati di revisionare il testo che intendi inviare alla lista devel-announce (passaggio successivo) e che prevedi di usare nel corpo del bug. Questo aiuterà a rendere il testo chiaro, comprensibile e privo di refusi o altri semplici errori. Assicurati che diverse persone visionino il testo e concordino sul fatto che descriva chiaramente il problema insieme alle relative soluzioni. Questo testo dovrebbe includere le istruzioni sviluppate in precedenza.

Annunciare su devel-announce

Una volta che avrai un’idea chiara delle modifiche necessarie, invia un’email esplicativa alla lista devel-announce. Attendi almeno una settimana per consentire ai manutentori di apportare le modifiche o di porti ulteriori domande sulla lista devel. Se la modifica deve essere effettuata entro una determinata scadenza, indicalo chiaramente nell’email. Se intendi far eseguire le modifiche a tutti i pacchetti non ancora aggiornati da un "provenpackager" o tramite un processo automatizzato, specifica anche questo nel messaggio.

Bug del tracciatore di file

Ora puoi aprire un bug di tracciamento su Bugzilla e segnalazioni per tutti i pacchetti che necessitano ancora di modifiche. Ricorda di verificare che i manutentori non abbiano già apportato i cambiamenti e di segnalare bug solo per i pacchetti che non lo hanno fatto.

Cose da annotare nei bug

  • Assicurati di annotare quali release ritieni debbano essere sistemate, o se sia sufficiente intervenire solo su Rawhide.

  • "Specifica se desideri che gli aggiornamenti vengano inviati esclusivamente per questa modifica, o se la modifica può essere caricata la prossima volta che ci sarà un altro motivo per aggiornare.

  • "Inserisci il link alla linea guida specifica interessata.

  • "Se la modifica è di piccola entità, includi specificamente ciò che il manutentore deve aggiungere o rimuovere dal proprio file spec."

  • "Se la modifica è di grande entità, includi un riepilogo dei cambiamenti necessari. Un collegamento a una pagina esterna con la documentazione completa è ovviamente necessario, ma un manutentore dovrebbe essere in grado di farsi un’idea di base della modifica già da quanto incluso nel bug stesso. Un link a una discussione su una mailing list non è assolutamente sufficiente."

  • "Prendi nota degli annunci e di eventuali discussioni sulle mailing list in cui la modifica è stata discussa.

  • "Prendi nota di eventuali scadenze oltre le quali i provenpackagers potrebbero intervenire e apportare modifiche.

  • "Indica dove i manutentori possono fornire feedback o richiedere maggiori informazioni se la segnalazione del bug non è chiara.

  • "Includi il nome del pacchetto nella riga del sommario (summary) di ogni bug figlio, in modo che sia possibile visualizzare rapidamente i componenti interessati nella vista ad albero.