1 .. SPDX-License-Identifier: GPL-2.0
5 ==================================
6 La documentazione del kernel Linux
7 ==================================
13 :manutentore: Federico Vaga <federico.vaga@vaga.pv.it>
15 Questo è il livello principale della documentazione del kernel in
16 lingua italiana. La traduzione è incompleta, noterete degli avvisi
17 che vi segnaleranno la mancanza di una traduzione o di un gruppo di
20 Più in generale, la documentazione, come il kernel stesso, sono in
21 costante sviluppo; particolarmente vero in quanto stiamo lavorando
22 alla riorganizzazione della documentazione in modo più coerente.
23 I miglioramenti alla documentazione sono sempre i benvenuti; per cui,
24 se vuoi aiutare, iscriviti alla lista di discussione linux-doc presso
32 L'obiettivo di questa traduzione è di rendere più facile la lettura e
33 la comprensione per chi non capisce l'inglese o ha dubbi sulla sua
34 interpretazione, oppure semplicemente per chi preferisce leggere in lingua
35 italiana. Tuttavia, tenete ben presente che l'*unica* documentazione
36 ufficiale è quella in lingua inglese: :ref:`linux_doc`
38 La propagazione simultanea a tutte le traduzioni di una modifica in
39 :ref:`linux_doc` è altamente improbabile. I manutentori delle traduzioni -
40 e i contributori - seguono l'evolversi della documentazione ufficiale e
41 cercano di mantenere le rispettive traduzioni allineate nel limite del
42 possibile. Per questo motivo non c'è garanzia che una traduzione sia
43 aggiornata all'ultima modifica. Se quello che leggete in una traduzione
44 non corrisponde a quello che leggete nel codice, informate il manutentore
45 della traduzione e - se potete - verificate anche la documentazione in
48 Una traduzione non è un *fork* della documentazione ufficiale, perciò gli
49 utenti non vi troveranno alcuna informazione diversa rispetto alla versione
50 ufficiale. Ogni aggiunta, rimozione o modifica dei contenuti deve essere
51 fatta prima nei documenti in inglese. In seguito, e quando è possibile, la
52 stessa modifica dovrebbe essere applicata anche alle traduzioni. I manutentori
53 delle traduzioni accettano contributi che interessano prettamente l'attività
54 di traduzione (per esempio, nuove traduzioni, aggiornamenti, correzioni).
56 Le traduzioni cercano di essere il più possibile accurate ma non è possibile
57 mappare direttamente una lingua in un'altra. Ogni lingua ha la sua grammatica
58 e una sua cultura alle spalle, quindi la traduzione di una frase in inglese
59 potrebbe essere modificata per adattarla all'italiano. Per questo motivo,
60 quando leggete questa traduzione, potreste trovare alcune differenze di forma
61 ma che trasmettono comunque il messaggio originale. Nonostante la grande
62 diffusione di inglesismi nella lingua parlata, quando possibile, questi
63 verranno sostituiti dalle corrispettive parole italiane
65 Se avete bisogno d'aiuto per comunicare con la comunità Linux ma non vi sentite
66 a vostro agio nello scrivere in inglese, potete chiedere aiuto al manutentore
69 Lavorare con la comunità di sviluppo
70 ====================================
72 Le guide fondamentali per l'interazione con la comunità di sviluppo del kernel e
73 su come vedere il proprio lavoro integrato.
78 process/development-process
79 process/submitting-patches
80 Code of conduct <process/code-of-conduct>
81 All development-process docs <process/index>
84 Manuali sull'API interna
85 ========================
87 Di seguito una serie di manuali per gli sviluppatori che hanno bisogno di
88 interfacciarsi con il resto del kernel.
94 Sincronizzazione nel kernel <locking/index>
97 Strumenti e processi per lo sviluppo
98 ====================================
100 Di seguito una serie di manuali contenenti informazioni utili a tutti gli
101 sviluppatori del kernel.
106 Regole sulle licenze <process/license-rules>
107 Scrivere la documentazione <doc-guide/index>
108 Strumenti di sviluppo <dev-tools/index>
109 La guida all'*hacking*<kernel-hacking/index>
112 Documentazione per gli utenti
113 =============================
115 Di seguito una serie di manuali per gli *utenti* del kernel - ovvero coloro che
116 stanno cercando di farlo funzionare al meglio per un dato sistema, ma anche
117 coloro che stanno sviluppando applicazioni che sfruttano l'API verso lo
120 Consultate anche `Linux man pages <https://www.kernel.org/doc/man-pages/>`_, che
121 vengono mantenuti separatamente dalla documentazione del kernel Linux
123 Documentazione relativa ai firmware
124 ===================================
125 Di seguito informazioni sulle aspettative del kernel circa i firmware.
128 Documentazione specifica per architettura
129 =========================================
135 Ci sono documenti che sono difficili da inserire nell'attuale organizzazione
136 della documentazione; altri hanno bisogno di essere migliorati e/o convertiti
137 nel formato *reStructuredText*; altri sono semplicamente troppo vecchi.