1 .. include:: ../disclaimer-ita.rst
3 :Original: :ref:`Documentation/process/howto.rst <process_howto>`
4 :Translator: Alessia Mantegazza <amantegazza@vaga.pv.it>
8 Come partecipare allo sviluppo del kernel Linux
9 ===============================================
11 Questo è il documento fulcro di quanto trattato sull'argomento.
12 Esso contiene le istruzioni su come diventare uno sviluppatore
13 del kernel Linux e spiega come lavorare con la comunità di
14 sviluppo kernel Linux. Il documento non tratterà alcun aspetto
15 tecnico relativo alla programmazione del kernel, ma vi aiuterà
16 indirizzandovi sulla corretta strada.
18 Se qualsiasi cosa presente in questo documento diventasse obsoleta,
19 vi preghiamo di inviare le correzioni agli amministratori di questo
20 file, indicati in fondo al presente documento.
24 Dunque, volete imparare come diventare sviluppatori del kernel Linux?
25 O vi è stato detto dal vostro capo, "Vai, scrivi un driver Linux per
26 questo dispositivo". Bene, l'obbiettivo di questo documento è quello
27 di insegnarvi tutto ciò che dovete sapere per raggiungere il vostro
28 scopo descrivendo il procedimento da seguire e consigliandovi
29 su come lavorare con la comunità. Il documento cercherà, inoltre,
30 di spiegare alcune delle ragioni per le quali la comunità lavora in un
33 Il kernel è scritto prevalentemente nel linguaggio C con alcune parti
34 specifiche dell'architettura scritte in linguaggio assembly.
35 Per lo sviluppo kernel è richiesta una buona conoscenza del linguaggio C.
36 L'assembly (di qualsiasi architettura) non è richiesto, a meno che non
37 pensiate di fare dello sviluppo di basso livello per un'architettura.
38 Sebbene essi non siano un buon sostituto ad un solido studio del
39 linguaggio C o ad anni di esperienza, i seguenti libri sono, se non
40 altro, utili riferimenti:
42 - "The C Programming Language" di Kernighan e Ritchie [Prentice Hall]
43 - "Practical C Programming" di Steve Oualline [O'Reilly]
44 - "C: A Reference Manual" di Harbison and Steele [Prentice Hall]
46 Il kernel è stato scritto usando GNU C e la toolchain GNU.
47 Sebbene si attenga allo standard ISO C89, esso utilizza una serie di
48 estensioni che non sono previste in questo standard. Il kernel è un
49 ambiente C indipendente, che non ha alcuna dipendenza dalle librerie
50 C standard, così alcune parti del C standard non sono supportate.
51 Le divisioni ``long long`` e numeri in virgola mobile non sono permessi.
52 Qualche volta è difficile comprendere gli assunti che il kernel ha
53 riguardo gli strumenti e le estensioni in uso, e sfortunatamente non
54 esiste alcuna indicazione definitiva. Per maggiori informazioni, controllate,
57 Tenete a mente che state cercando di apprendere come lavorare con la comunità
58 di sviluppo già esistente. Questo è un gruppo eterogeneo di persone, con alti
59 standard di codifica, di stile e di procedura. Questi standard sono stati
60 creati nel corso del tempo basandosi su quanto hanno riscontrato funzionare al
61 meglio per un squadra così grande e geograficamente sparsa. Cercate di
62 imparare, in anticipo, il più possibile circa questi standard, poichè ben
63 spiegati; non aspettatevi che gli altri si adattino al vostro modo di fare
64 o a quello della vostra azienda.
68 Il codice sorgente del kernel Linux è rilasciato sotto GPL. Siete pregati
69 di visionare il file, COPYING, presente nella cartella principale dei
70 sorgente, per eventuali dettagli sulla licenza. Se avete ulteriori domande
71 sulla licenza, contattate un avvocato, non chiedete sulle liste di discussione
72 del kernel Linux. Le persone presenti in queste liste non sono avvocati,
73 e non dovreste basarvi sulle loro dichiarazioni in materia giuridica.
75 Per domande più frequenti e risposte sulla licenza GPL, guardare:
77 https://www.gnu.org/licenses/gpl-faq.html
81 I sorgenti del kernel Linux hanno una vasta base di documenti che vi
82 insegneranno come interagire con la comunità del kernel. Quando nuove
83 funzionalità vengono aggiunte al kernel, si raccomanda di aggiungere anche i
84 relativi file di documentatione che spiegano come usarele.
85 Quando un cambiamento del kernel genera anche un cambiamento nell'interfaccia
86 con lo spazio utente, è raccomandabile che inviate una notifica o una
87 correzione alle pagine *man* spiegando tale modifica agli amministratori di
88 queste pagine all'indirizzo mtk.manpages@gmail.com, aggiungendo
89 in CC la lista linux-api@vger.kernel.org.
91 Di seguito una lista di file che sono presenti nei sorgente del kernel e che
92 è richiesto che voi leggiate:
94 :ref:`Documentation/translations/it_IT/admin-guide/README.rst <it_readme>`
95 Questo file da una piccola anteprima del kernel Linux e descrive il
96 minimo necessario per configurare e generare il kernel. I novizi
97 del kernel dovrebbero iniziare da qui.
99 :ref:`Documentation/translations/it_IT/process/changes.rst <it_changes>`
101 Questo file fornisce una lista dei pacchetti software necessari
102 a compilare e far funzionare il kernel con successo.
104 :ref:`Documentation/translations/it_IT/process/coding-style.rst <it_codingstyle>`
106 Questo file descrive lo stile della codifica per il kernel Linux,
107 e parte delle motivazioni che ne sono alla base. Tutto il nuovo codice deve
108 seguire le linee guida in questo documento. Molti amministratori
109 accetteranno patch solo se queste osserveranno tali regole, e molte
110 persone revisioneranno il codice solo se scritto nello stile appropriato.
112 :ref:`Documentation/translations/it_IT/process/submitting-patches.rst <it_submittingpatches>` e
113 :ref:`Documentation/translations/it_IT/process/submitting-drivers.rst <it_submittingdrivers>`
115 Questo file descrive dettagliatamente come creare ed inviare una patch
116 con successo, includendo (ma non solo questo):
118 - Contenuto delle email
119 - Formato delle email
120 - I destinatari delle email
122 Seguire tali regole non garantirà il successo (tutte le patch sono soggette
123 a controlli realitivi a contenuto e stile), ma non seguirle lo precluderà
126 Altre ottime descrizioni di come creare buone patch sono:
129 https://www.ozlabs.org/~akpm/stuff/tpp.txt
131 "Linux kernel patch submission format"
132 http://linux.yyz.us/patch-format.html
134 :ref:`Documentation/translations/it_IT/process/stable-api-nonsense.rst <it_stable_api_nonsense>`
136 Questo file descrive la motivazioni sottostanti la conscia decisione di
137 non avere un API stabile all'interno del kernel, incluso cose come:
139 - Sottosistemi shim-layers (per compatibilità?)
140 - Portabilità fra Sistemi Operativi dei driver.
141 - Attenuare i rapidi cambiamenti all'interno dei sorgenti del kernel
144 Questo documento è vitale per la comprensione della filosifia alla base
145 dello sviluppo di Linux ed è molto importante per le persone che arrivano
146 da esperienze con altri Sistemi Operativi.
148 :ref:`Documentation/translations/it_IT/admin-guide/security-bugs.rst <it_securitybugs>`
149 Se ritenete di aver trovato un problema di sicurezza nel kernel Linux,
150 seguite i passaggi scritti in questo documento per notificarlo agli
151 sviluppatori del kernel, ed aiutare la risoluzione del problema.
153 :ref:`Documentation/translations/it_IT/process/management-style.rst <it_managementstyle>`
154 Questo documento descrive come i manutentori del kernel Linux operano
155 e la filosofia comune alla base del loro metodo. Questa è un'importante
156 lettura per tutti coloro che sono nuovi allo sviluppo del kernel (o per
157 chi è semplicemente curioso), poiché risolve molti dei più comuni
158 fraintendimenti e confusioni dovuti al particolare comportamento dei
159 manutentori del kernel.
161 :ref:`Documentation/translations/it_IT/process/stable-kernel-rules.rst <it_stable_kernel_rules>`
162 Questo file descrive le regole sulle quali vengono basati i rilasci del
163 kernel, e spiega cosa fare se si vuole che una modifica venga inserita
164 in uno di questi rilasci.
166 :ref:`Documentation/translations/it_IT/process/kernel-docs.rst <it_kernel_docs>`
167 Una lista di documenti pertinenti allo sviluppo del kernel.
168 Per favore consultate questa lista se non trovate ciò che cercate nella
169 documentazione interna del kernel.
171 :ref:`Documentation/translations/it_IT/process/applying-patches.rst <it_applying_patches>`
172 Una buona introduzione che descrivere esattamente cos'è una patch e come
173 applicarla ai differenti rami di sviluppo del kernel.
175 Il kernel inoltre ha un vasto numero di documenti che possono essere
176 automaticamente generati dal codice sorgente stesso o da file
177 ReStructuredText (ReST), come questo. Esso include una completa
178 descrizione dell'API interna del kernel, e le regole su come gestire la
179 sincronizzazione (locking) correttamente
181 Tutte queste tipologie di documenti possono essere generati in PDF o in
187 rispettivamente dalla cartella principale dei sorgenti del kernel.
189 I documenti che impiegano ReST saranno generati nella cartella
190 Documentation/output.
191 Questi posso essere generati anche in formato LaTex e ePub con::
196 Diventare uno sviluppatore del kernel
197 -------------------------------------
198 Se non sapete nulla sullo sviluppo del kernel Linux, dovreste dare uno
199 sguardo al progetto *Linux KernelNewbies*:
201 https://kernelnewbies.org
203 Esso prevede un'utile lista di discussione dove potete porre più o meno ogni
204 tipo di quesito relativo ai concetti fondamentali sullo sviluppo del kernel
205 (assicuratevi di cercare negli archivi, prima di chiedere qualcosa alla
206 quale è già stata fornita risposta in passato). Esistono inoltre, un canale IRC
207 che potete usare per formulare domande in tempo reale, e molti documenti utili
208 che vi faciliteranno nell'apprendimento dello sviluppo del kernel Linux.
210 Il sito internet contiene informazioni di base circa l'organizzazione del
211 codice, sottosistemi e progetti attuali (sia interni che esterni a Linux).
212 Esso descrive, inoltre, informazioni logistiche di base, riguardanti ad esempio
213 la compilazione del kernel e l'applicazione di una modifica.
215 Se non sapete dove cominciare, ma volete cercare delle attività dalle quali
216 partire per partecipare alla comunità di sviluppo, andate al progetto Linux
219 https://kernelnewbies.org/KernelJanitors
221 È un buon posto da cui iniziare. Esso presenta una lista di problematiche
222 relativamente semplici da sistemare e pulire all'interno della sorgente del
223 kernel Linux. Lavorando con gli sviluppatori incaricati di questo progetto,
224 imparerete le basi per l'inserimento delle vostre modifiche all'interno dei
225 sorgenti del kernel Linux, e possibilmente, sarete indirizzati al lavoro
226 successivo da svolgere, se non ne avrete ancora idea.
228 Prima di apportare una qualsiasi modifica al codice del kernel Linux,
229 è imperativo comprendere come tale codice funziona. A questo scopo, non c'è
230 nulla di meglio che leggerlo direttamente (la maggior parte dei bit più
231 complessi sono ben commentati), eventualmente anche con l'aiuto di strumenti
232 specializzati. Uno degli strumenti che è particolarmente raccomandato è
233 il progetto Linux Cross-Reference, che è in grado di presentare codice
234 sorgente in un formato autoreferenziale ed indicizzato. Un eccellente ed
235 aggiornata fonte di consultazione del codice del kernel la potete trovare qui:
237 https://elixir.bootlin.com/
240 Il processo di sviluppo
241 -----------------------
242 Il processo di sviluppo del kernel Linux si compone di pochi "rami" principali
243 e di molti altri rami per specifici sottosistemi. Questi rami sono:
245 - I sorgenti kernel 4.x
246 - I sorgenti stabili del kernel 4.x.y -stable
247 - Sorgenti dei sottosistemi del kernel e le loro modifiche
248 - Il kernel 4.x -next per test d'integrazione
250 I sorgenti kernel 4.x
251 ~~~~~~~~~~~~~~~~~~~~~
253 I kernel 4.x sono amministrati da Linus Torvald, e possono essere trovati
254 su https://kernel.org nella cartella pub/linux/kernel/v4.x/. Il processo
255 di sviluppo è il seguente:
257 - Non appena un nuovo kernel viene rilasciato si apre una finestra di due
258 settimane. Durante questo periodo i manutentori possono proporre a Linus
259 dei grossi cambiamenti; solitamente i cambiamenti che sono già stati
260 inseriti nel ramo -next del kernel per alcune settimane. Il modo migliore
261 per sottoporre dei cambiamenti è attraverso git (lo strumento usato per
262 gestire i sorgenti del kernel, più informazioni sul sito
263 https://git-scm.com/) ma anche delle patch vanno bene.
265 - Al termine delle due settimane un kernel -rc1 viene rilasciato e
266 l'obbiettivo ora è quello di renderlo il più solido possibile. A questo
267 punto la maggior parte delle patch dovrebbero correggere un'eventuale
268 regressione. I bachi che sono sempre esistiti non sono considerabili come
269 regressioni, quindi inviate questo tipo di cambiamenti solo se sono
270 importanti. Notate che un intero driver (o filesystem) potrebbe essere
271 accettato dopo la -rc1 poiché non esistono rischi di una possibile
272 regressione con tale cambiamento, fintanto che quest'ultimo è
273 auto-contenuto e non influisce su aree esterne al codice che è stato
274 aggiunto. git può essere utilizzato per inviare le patch a Linus dopo che
275 la -rc1 è stata rilasciata, ma è anche necessario inviare le patch ad
276 una lista di discussione pubblica per un'ulteriore revisione.
278 - Una nuova -rc viene rilasciata ogni volta che Linus reputa che gli attuali
279 sorgenti siano in uno stato di salute ragionevolmente adeguato ai test.
280 L'obiettivo è quello di rilasciare una nuova -rc ogni settimana.
282 - Il processo continua fino a che il kernel è considerato "pronto"; tale
283 processo dovrebbe durare circa in 6 settimane.
285 È utile menzionare quanto scritto da Andrew Morton sulla lista di discussione
286 kernel-linux in merito ai rilasci del kernel:
288 *"Nessuno sa quando un kernel verrà rilasciato, poichè questo è
289 legato allo stato dei bachi e non ad una cronologia preventiva."*
291 I sorgenti stabili del kernel 4.x.y -stable
292 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
294 I kernel con versioni in 3-parti sono "kernel stabili". Essi contengono
295 correzioni critiche relativamente piccole nell'ambito della sicurezza
296 oppure significative regressioni scoperte in un dato 4.x kernel.
298 Questo è il ramo raccomandato per gli utenti che vogliono un kernel recente
299 e stabile e non sono interessati a dare il proprio contributo alla verifica
300 delle versioni di sviluppo o sperimentali.
302 Se non è disponibile alcun kernel 4.x.y., quello più aggiornato e stabile
303 sarà il kernel 4.x con la numerazione più alta.
305 4.x.y sono amministrati dal gruppo "stable" <stable@vger.kernel.org>, e sono
306 rilasciati a seconda delle esigenze. Il normale periodo di rilascio è
307 approssimativamente di due settimane, ma può essere più lungo se non si
308 verificano problematiche urgenti. Un problema relativo alla sicurezza, invece,
309 può determinare un rilascio immediato.
311 Il file Documentation/process/stable-kernel-rules.rst (nei sorgenti) documenta
312 quali tipologie di modifiche sono accettate per i sorgenti -stable, e come
313 avviene il processo di rilascio.
316 Sorgenti dei sottosistemi del kernel e le loro patch
317 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
319 I manutentori dei diversi sottosistemi del kernel --- ed anche molti
320 sviluppatori di sottosistemi --- mostrano il loro attuale stato di sviluppo
321 nei loro repositori. In questo modo, altri possono vedere cosa succede nelle
322 diverse parti del kernel. In aree dove lo sviluppo è rapido, potrebbe essere
323 chiesto ad uno sviluppatore di basare le proprie modifiche su questi repositori
324 in modo da evitare i conflitti fra le sottomissioni ed altri lavori in corso
326 La maggior parte di questi repositori sono git, ma esistono anche altri SCM
327 in uso, o file di patch pubblicate come una serie quilt.
328 Gli indirizzi dei repositori di sottosistema sono indicati nel file
329 MAINTAINERS. Molti di questi posso essere trovati su https://git.kernel.org/.
331 Prima che una modifica venga inclusa in questi sottosistemi, sarà soggetta ad
332 una revisione che inizialmente avviene tramite liste di discussione (vedere la
333 sezione dedicata qui sotto). Per molti sottosistemi del kernel, tale processo
334 di revisione è monitorato con lo strumento patchwork.
335 Patchwork offre un'interfaccia web che mostra le patch pubblicate, inclusi i
336 commenti o le revisioni fatte, e gli amministratori possono indicare le patch
337 come "in revisione", "accettate", o "rifiutate". Diversi siti Patchwork sono
338 elencati al sito https://patchwork.kernel.org/.
340 Il kernel 4.x -next per test d'integrazione
341 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
343 Prima che gli aggiornamenti dei sottosistemi siano accorpati nel ramo
344 principale 4.x, sarà necessario un test d'integrazione.
345 A tale scopo, esiste un repositorio speciale di test nel quale virtualmente
346 tutti i rami dei sottosistemi vengono inclusi su base quotidiana:
348 https://git.kernel.org/?p=linux/kernel/git/next/linux-next.git
350 In questo modo, i kernel -next offrono uno sguardo riassuntivo su quello che
351 ci si aspetterà essere nel kernel principale nel successivo periodo
353 Coloro che vorranno fare dei test d'esecuzione del kernel -next sono più che
360 https://bugzilla.kernel.org è dove gli sviluppatori del kernel Linux tracciano
361 i bachi del kernel. Gli utenti sono incoraggiati nel riportare tutti i bachi
362 che trovano utilizzando questo strumento.
363 Per maggiori dettagli su come usare il bugzilla del kernel, guardare:
365 https://bugzilla.kernel.org/page.cgi?id=faq.html
367 Il file admin-guide/reporting-bugs.rst nella cartella principale del kernel
368 fornisce un buon modello sul come segnalare un baco nel kernel, e spiega quali
369 informazioni sono necessarie agli sviluppatori per poter aiutare il
370 rintracciamento del problema.
372 Gestire i rapporti sui bug
373 --------------------------
375 Uno dei modi migliori per mettere in pratica le vostre capacità di hacking è
376 quello di riparare bachi riportati da altre persone. Non solo aiuterete a far
377 diventare il kernel più stabile, ma imparerete a riparare problemi veri dal
378 mondo ed accrescerete le vostre competenze, e gli altri sviluppatori saranno
379 al corrente della vostra presenza. Riparare bachi è una delle migliori vie per
380 acquisire meriti tra gli altri sviluppatori, perchè non a molte persone piace
381 perdere tempo a sistemare i bachi di altri.
383 Per lavorare sui rapporti di bachi già riportati, andate su
384 https://bugzilla.kernel.org.
389 Come descritto in molti dei documenti qui sopra, la maggior parte degli
390 sviluppatori del kernel partecipano alla lista di discussione Linux Kernel.
391 I dettagli su come iscriversi e disiscriversi dalla lista possono essere
394 http://vger.kernel.org/vger-lists.html#linux-kernel
396 Ci sono diversi archivi della lista di discussione. Usate un qualsiasi motore
397 di ricerca per trovarli. Per esempio:
399 http://dir.gmane.org/gmane.linux.kernel
401 É caldamente consigliata una ricerca in questi archivi sul tema che volete
402 sollevare, prima di pubblicarlo sulla lista. Molte cose sono già state
403 discusse in dettaglio e registrate negli archivi della lista di discussione.
405 Molti dei sottosistemi del kernel hanno anche una loro lista di discussione
406 dedicata. Guardate nel file MAINTAINERS per avere una lista delle liste di
407 discussione e il loro uso.
409 Molte di queste liste sono gestite su kernel.org. Per informazioni consultate
412 http://vger.kernel.org/vger-lists.html
414 Per favore ricordatevi della buona educazione quando utilizzate queste liste.
415 Sebbene sia un pò dozzinale, il seguente URL contiene alcune semplici linee
416 guida per interagire con la lista (o con qualsiasi altra lista):
418 http://www.albion.com/netiquette/
420 Se diverse persone rispondo alla vostra mail, la lista dei riceventi (copia
421 conoscenza) potrebbe diventare abbastanza lunga. Non cancellate nessuno dalla
422 lista di CC: senza un buon motivo, e non rispondete solo all'indirizzo
423 della lista di discussione. Fateci l'abitudine perché capita spesso di
424 ricevere la stessa email due volte: una dal mittente ed una dalla lista; e non
425 cercate di modificarla aggiungendo intestazioni stravaganti, agli altri non
428 Ricordate di rimanere sempre in argomento e di mantenere le attribuzioni
429 delle vostre risposte invariate; mantenete il "John Kernelhacker wrote ...:"
430 in cima alla vostra replica e aggiungete le vostre risposte fra i singoli
431 blocchi citati, non scrivete all'inizio dell'email.
433 Se aggiungete patch alla vostra mail, assicuratevi che siano del tutto
434 leggibili come indicato in Documentation/process/submitting-patches.rst.
435 Gli sviluppatori kernel non vogliono avere a che fare con allegati o patch
436 compresse; vogliono invece poter commentare le righe dei vostri cambiamenti,
437 il che può funzionare solo in questo modo.
438 Assicuratevi di utilizzare un gestore di mail che non alterì gli spazi ed i
439 caratteri. Un ottimo primo test è quello di inviare a voi stessi una mail e
440 cercare di sottoporre la vostra stessa patch. Se non funziona, sistemate il
441 vostro programma di posta, o cambiatelo, finché non funziona.
443 Ed infine, per favore ricordatevi di mostrare rispetto per gli altri
446 Lavorare con la comunità
447 ------------------------
449 L'obiettivo di questa comunità è quello di fornire il miglior kernel possibile.
450 Quando inviate una modifica che volete integrare, sarà valutata esclusivamente
451 dal punto di vista tecnico. Quindi, cosa dovreste aspettarvi?
455 - richieste di cambiamento
456 - richieste di spiegazioni
459 Ricordatevi che questo fa parte dell'integrazione della vostra modifica
460 all'interno del kernel. Dovete essere in grado di accettare le critiche,
461 valutarle a livello tecnico ed eventualmente rielaborare nuovamente le vostre
462 modifiche o fornire delle chiare e concise motivazioni per le quali le
463 modifiche suggerite non dovrebbero essere fatte.
464 Se non riceverete risposte, aspettate qualche giorno e riprovate ancora,
465 qualche volta le cose si perdono nell'enorme mucchio di email.
467 Cosa non dovreste fare?
469 - aspettarvi che la vostra modifica venga accettata senza problemi
470 - mettervi sulla difensiva
471 - ignorare i commenti
472 - sottomettere nuovamente la modifica senza fare nessuno dei cambiamenti
475 In una comunità che è alla ricerca delle migliori soluzioni tecniche possibili,
476 ci saranno sempre opinioni differenti sull'utilità di una modifica.
477 Siate cooperativi e vogliate adattare la vostra idea in modo che sia inserita
478 nel kernel. O almeno vogliate dimostrare che la vostra idea vale.
479 Ricordatevi, sbagliare è accettato fintanto che siate disposti a lavorare verso
480 una soluzione che è corretta.
482 È normale che le risposte alla vostra prima modifica possa essere
483 semplicemente una lista con dozzine di cose che dovreste correggere.
484 Questo **non** implica che la vostra patch non sarà accettata, e questo
485 **non** è contro di voi personalmente.
486 Semplicemente correggete tutte le questioni sollevate contro la vostra modifica
487 ed inviatela nuovamente.
489 Differenze tra la comunità del kernel e le strutture aziendali
490 --------------------------------------------------------------
492 La comunità del kernel funziona diversamente rispetto a molti ambienti di
493 sviluppo aziendali. Qui di seguito una lista di cose che potete provare a
494 fare per evitare problemi:
496 Cose da dire riguardanti le modifiche da voi proposte:
498 - "Questo risolve più problematiche."
499 - "Questo elimina 2000 stringhe di codice."
500 - "Qui una modifica che spiega cosa sto cercando di fare."
501 - "L'ho testato su 5 diverse architetture.."
502 - "Qui una serie di piccole modifiche che.."
503 - "Questo aumenta le prestazioni di macchine standard..."
505 Cose che dovreste evitare di dire:
507 - "Lo abbiamo fatto in questo modo in AIX/ptx/Solaris, di conseguenza
508 deve per forza essere giusto..."
509 - "Ho fatto questo per 20 anni, quindi.."
510 - "Questo è richiesto dalla mia Azienda per far soldi"
511 - "Questo è per la linea di prodotti della nostra Azienda"
512 - "Ecco il mio documento di design di 1000 pagine che descrive ciò che ho
514 - "Ci ho lavorato per 6 mesi..."
515 - "Ecco una patch da 5000 righe che.."
516 - "Ho riscritto il pasticcio attuale, ed ecco qua.."
517 - "Ho una scadenza, e questa modifica ha bisogno di essere approvata ora"
519 Un'altra cosa nella quale la comunità del kernel si differenzia dai più
520 classici ambienti di ingegneria del software è la natura "senza volto" delle
521 interazioni umane. Uno dei benefici dell'uso delle email e di irc come forma
522 primordiale di comunicazione è l'assenza di discriminazione basata su genere e
523 razza. L'ambienti di lavoro Linux accetta donne e minoranze perchè tutto quello
524 che sei è un indirizzo email. Aiuta anche l'aspetto internazionale nel
525 livellare il terreno di gioco perchè non è possibile indovinare il genere
526 basandosi sul nome di una persona. Un uomo può chiamarsi Andrea ed una donna
527 potrebbe chiamarsi Pat. Gran parte delle donne che hanno lavorato al kernel
528 Linux e che hanno espresso una personale opinione hanno avuto esperienze
531 La lingua potrebbe essere un ostacolo per quelle persone che non si trovano
532 a loro agio con l'inglese. Una buona padronanza del linguaggio può essere
533 necessaria per esporre le proprie idee in maniera appropiata all'interno
534 delle liste di discussione, quindi è consigliabile che rileggiate le vostre
535 email prima di inviarle in modo da essere certi che abbiano senso in inglese.
538 Spezzare le vostre modifiche
539 ----------------------------
541 La comunità del kernel Linux non accetta con piacere grossi pezzi di codice
542 buttati lì tutti in una volta. Le modifiche necessitano di essere
543 adeguatamente presentate, discusse, e suddivise in parti più piccole ed
544 indipendenti. Questo è praticamente l'esatto opposto di quello che le
545 aziende fanno solitamente. La vostra proposta dovrebbe, inoltre, essere
546 presentata prestissimo nel processo di sviluppo, così che possiate ricevere
547 un riscontro su quello che state facendo. Lasciate che la comunità
548 senta che state lavorando con loro, e che non li stiate sfruttando come
549 discarica per le vostre aggiunte. In ogni caso, non inviate 50 email nello
550 stesso momento in una lista di discussione, il più delle volte la vostra serie
551 di modifiche dovrebbe essere più piccola.
553 I motivi per i quali dovreste frammentare le cose sono i seguenti:
555 1) Piccole modifiche aumentano le probabilità che vengano accettate,
556 altrimenti richiederebbe troppo tempo o sforzo nel verificarne
557 la correttezza. Una modifica di 5 righe può essere accettata da un
558 manutentore con a mala pena una seconda occhiata. Invece, una modifica da
559 500 linee può richiedere ore di rilettura per verificarne la correttezza
560 (il tempo necessario è esponenzialmente proporzionale alla dimensione della
561 modifica, o giù di lì)
563 Piccole modifiche sono inoltre molto facili da debuggare quando qualcosa
564 non va. È molto più facile annullare le modifiche una per una che
565 dissezionare una patch molto grande dopo la sua sottomissione (e rompere
568 2) È importante non solo inviare piccole modifiche, ma anche riscriverle e
569 semplificarle (o più semplicemente ordinarle) prima di sottoporle.
571 Qui un'analogia dello sviluppatore kernel Al Viro:
573 *"Pensate ad un insegnante di matematica che corregge il compito
574 di uno studente (di matematica). L'insegnante non vuole vedere le
575 prove e gli errori commessi dallo studente prima che arrivi alla
576 soluzione. Vuole vedere la risposta più pulita ed elegante
577 possibile. Un buono studente lo sa, e non presenterebbe mai le
578 proprie bozze prima prima della soluzione finale"*
580 *"Lo stesso vale per lo sviluppo del kernel. I manutentori ed i
581 revisori non vogliono vedere il procedimento che sta dietro al
582 problema che uno sta risolvendo. Vogliono vedere una soluzione
583 semplice ed elegante."*
585 Può essere una vera sfida il saper mantenere l'equilibrio fra una presentazione
586 elegante della vostra soluzione, lavorare insieme ad una comunità e dibattere
587 su un lavoro incompleto. Pertanto è bene entrare presto nel processo di
588 revisione per migliorare il vostro lavoro, ma anche per riuscire a tenere le
589 vostre modifiche in pezzettini che potrebbero essere già accettate, nonostante
590 la vostra intera attività non lo sia ancora.
592 In fine, rendetevi conto che non è accettabile inviare delle modifiche
593 incomplete con la promessa che saranno "sistemate dopo".
596 Giustificare le vostre modifiche
597 --------------------------------
599 Insieme alla frammentazione delle vostre modifiche, è altrettanto importante
600 permettere alla comunità Linux di capire perché dovrebbero accettarle.
601 Nuove funzionalità devono essere motivate come necessarie ed utili.
604 Documentare le vostre modifiche
605 -------------------------------
607 Quando inviate le vostre modifiche, fate particolare attenzione a quello che
608 scrivete nella vostra email. Questa diventerà il *ChangeLog* per la modifica,
609 e sarà visibile a tutti per sempre. Dovrebbe descrivere la modifica nella sua
610 interezza, contenendo:
612 - perchè la modifica è necessaria
613 - l'approccio d'insieme alla patch
614 - dettagli supplementari
617 Per maggiori dettagli su come tutto ciò dovrebbe apparire, riferitevi alla
618 sezione ChangeLog del documento:
621 http://www.ozlabs.org/~akpm/stuff/tpp.txt
623 A volte tutto questo è difficile da realizzare. Il perfezionamento di queste
624 pratiche può richiedere anni (eventualmente). È un processo continuo di
625 miglioramento che richiede molta pazienza e determinazione. Ma non mollate,
626 si può fare. Molti lo hanno fatto prima, ed ognuno ha dovuto iniziare dove
634 Grazie a Paolo Ciarrocchi che ha permesso che la sezione "Development Process"
635 (https://lwn.net/Articles/94386/) fosse basata sui testi da lui scritti, ed a
636 Randy Dunlap e Gerrit Huizenga per la lista di cose che dovreste e non
637 dovreste dire. Grazie anche a Pat Mochel, Hanna Linder, Randy Dunlap,
638 Kay Sievers, Vojtech Pavlik, Jan Kara, Josh Boyer, Kees Cook, Andrew Morton,
639 Andi Kleen, Vadim Lobanov, Jesper Juhl, Adrian Bunk, Keri Harris, Frans Pop,
640 David A. Wheeler, Junio Hamano, Michael Kerrisk, e Alex Shepard per le
641 loro revisioni, commenti e contributi. Senza il loro aiuto, questo documento
642 non sarebbe stato possibile.
644 Manutentore: Greg Kroah-Hartman <greg@kroah.com>