1*1e6c6d69SFederico Vaga.. SPDX-License-Identifier: GPL-2.0 2*1e6c6d69SFederico Vaga 3*1e6c6d69SFederico Vaga.. include:: ../disclaimer-ita.rst 4*1e6c6d69SFederico Vaga 5*1e6c6d69SFederico VagaProfilo del manutentore del sottosistema di documentazione 6*1e6c6d69SFederico Vaga========================================================== 7*1e6c6d69SFederico Vaga 8*1e6c6d69SFederico VagaIl "sottosistema" della documentazione è il punto di coordinamento 9*1e6c6d69SFederico Vagacentrale per la documentazione del kernel e la relativa infrastruttura. 10*1e6c6d69SFederico VagaCopre la gerarchia sotto Documentation/ (con l'eccezione di 11*1e6c6d69SFederico VagaDocumentation/devicetree), diverse utilità sotto scripts/ e, almeno in 12*1e6c6d69SFederico Vagaparte, LICENSES/. 13*1e6c6d69SFederico Vaga 14*1e6c6d69SFederico VagaVale la pena notare, però, che i confini di questo sottosistema sono più sfumati 15*1e6c6d69SFederico Vagadel normale. Molti altri manutentori di sottosistemi preferiscono mantenere il 16*1e6c6d69SFederico Vagacontrollo di alcune parti di Documentation/, e molti altri ancora vi applicano 17*1e6c6d69SFederico Vagaliberamente delle modifiche quando è conveniente. Oltre a ciò, buona parte della 18*1e6c6d69SFederico Vagadocumentazione del kernel si trova nel codice sorgente sotto forma di commenti 19*1e6c6d69SFederico Vagakerneldoc; questi sono solitamente (ma non sempre) mantenuti dal manutentore del 20*1e6c6d69SFederico Vagasottosistema pertinente. 21*1e6c6d69SFederico Vaga 22*1e6c6d69SFederico VagaLa lista di discussione per la documentazione è linux-doc@vger.kernel.org. 23*1e6c6d69SFederico VagaLe patch dovrebbero essere inviate contro l'albero docs-next quando 24*1e6c6d69SFederico Vagapossibile. 25*1e6c6d69SFederico Vaga 26*1e6c6d69SFederico VagaAggiunta alla checklist di invio 27*1e6c6d69SFederico Vaga-------------------------------- 28*1e6c6d69SFederico Vaga 29*1e6c6d69SFederico VagaQuando si apportano modifiche alla documentazione, dovreste generare 30*1e6c6d69SFederico Vagaeffettivamente la documentazione e assicurarvi che non siano stati 31*1e6c6d69SFederico Vagaintrodotti nuovi errori o avvisi. Generare i documenti in HTML e osservare 32*1e6c6d69SFederico Vagail risultato aiuterà a evitare fraintendimenti spiacevoli su come le cose 33*1e6c6d69SFederico Vagaverranno rappresentate. 34*1e6c6d69SFederico Vaga 35*1e6c6d69SFederico VagaTutta la nuova documentazione (incluse le aggiunte a documenti esistenti) 36*1e6c6d69SFederico Vagadovrebbe idealmente giustificare, da qualche parte nel changelog, chi sia 37*1e6c6d69SFederico Vagail pubblico a cui è destinata; in questo modo, ci assicuriamo che la 38*1e6c6d69SFederico Vagadocumentazione finisca nel posto giusto. Alcune categorie possibili 39*1e6c6d69SFederico Vagasono: sviluppatori del kernel (esperti o principianti), programmatori 40*1e6c6d69SFederico Vagadello spazio utente, utenti finali e/o amministratori di sistema, e 41*1e6c6d69SFederico Vagadistributori. 42*1e6c6d69SFederico Vaga 43*1e6c6d69SFederico VagaDate chiave del ciclo 44*1e6c6d69SFederico Vaga--------------------- 45*1e6c6d69SFederico Vaga 46*1e6c6d69SFederico VagaLe patch possono essere inviate in qualsiasi momento, ma la risposta sarà 47*1e6c6d69SFederico Vagapiù lenta del solito durante la finestra d'integrazione. L'albero della 48*1e6c6d69SFederico Vagadocumentazione tende a chiudersi tardi, prima dell'apertura della finestra 49*1e6c6d69SFederico Vagad'integrazione, poiché il rischio di regressioni dovute a patch sulla 50*1e6c6d69SFederico Vagadocumentazione è basso. 51*1e6c6d69SFederico Vaga 52*1e6c6d69SFederico VagaCadenza di revisione 53*1e6c6d69SFederico Vaga-------------------- 54*1e6c6d69SFederico Vaga 55*1e6c6d69SFederico VagaSono (Jonathan Corbet) l'unico manutentore del sottosistema di documentazione, e 56*1e6c6d69SFederico Vagasvolgo questo lavoro nel mio tempo libero, quindi la risposta alle patch sarà a 57*1e6c6d69SFederico Vagavolte lenta. Cerco sempre di inviare una notifica quando una patch viene 58*1e6c6d69SFederico Vagaintegrata (o quando decido che non può esserlo). Non esitate a inviare un 59*1e6c6d69SFederico Vagasollecito se non avete ricevuto risposta entro una settimana dall'invio di una 60*1e6c6d69SFederico Vagapatch. 61