Il repository CVS di FreeBSD ha un numero di componenti che, se combinati, supportano i sorgenti di base del sistema operativo, la documentazione, l'infrastruttura dei port delle applicazioni di terze parti, e vari programmi di utilità. Quando vengono assegnati i bit di commit di FreeBSD, vengono specificate le aree dell'albero dove il bit può essere usato. Solitamente, le aree associate a un bit corrispondono a quelle di chi ha autorizzato l'assegnamento del bit di commit. Ulteriori aree di autorità possono essere aggiunte in seguito: se occorrerà, il committer dovrà seguire le normali procedure di allocazione del bit di commit per quell'area dell'albero, chiedendo l'approvazione all'entità appropriata e possibilmente prendendo un mentore per quell'area per un po' di tempo.
Tipo di Committer | Responsabile | Componenti dell'Albero |
src | core@ | src/, doc/ soggetta ad appropriata revisione |
doc | doceng@ | doc/, www/, documentazione src/ |
ports | portmgr@ | ports/ |
I bit di commit assegnati prima dello sviluppo della nozione di aree di autorità possono essere usati in molte parti dell'albero. Tuttavia, il buon senso dice che un committer che non ha mai lavorato precedentemente in un'area dell'albero chieda una revisione del proprio lavoro prima di effettuare il commit, chieda l'approvazione del responsabile appropriato, e/o lavori d'accordo con un mentore. Dato che le regole sulla manutenzione del codice differiscono a seconda dell'area dell'albero, questo è per il bene del committer che lavora in un'area poco familiare tanto quanto per gli altri che lavorano sull'albero.
I committer sono incoraggiati a chiedere la revisione del proprio lavoro come parte del normale processo di sviluppo, indifferentemente dall'area dell'albero in cui stanno lavorando.
I doc committer possono effettuare commit riguardanti modifiche alla documentazione sui file src, come pagine man, README, database dei fortune, file dei calendari, e correzioni sui commenti senza l'approvazione di un src committer, prestando la solita attenzione e cura ai commit.
I doc committer possono effettuare commit riguardanti piccole modifiche e correzioni ai sorgenti, come correzioni per la compilazione, piccole funzionalità, ecc., con un “Approved by” di un src committer.
I doc committer possono cercare di ottenere il commit bit sui src acquisendo un mentore, che proporrà il doc committer al core. Una volta approvato, verrà aggiunto al file access ed inizierà il normale periodo sotto la guida del mentore, che implica l'aggiunta di “Approved by” per un certo periodo.
“Approved by” può essere usato solamente se l'approvazione è di un src committer senza mentore — i committer ancora sotto la guida di un mentore possono fornire al più un “Reviewed by” ma non un “Approved by”.
Questo, ed altri documenti, possono essere scaricati da ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/.
Per domande su FreeBSD, leggi la documentazione prima di contattare <questions@FreeBSD.org>.
Per domande su questa documentazione, invia una e-mail a <doc@FreeBSD.org>.