Het Gentoo Handboek is beschikbaar in de volgende talen:

Braziliaans Portugees | Deens | Duits | Engels | Frans | Indonesisch | Italiaans | Japans | Pools | Romenisch | Spaans | Traditioneel Chinees

Welkom bij de Gentoo Handboek pagina. Deze pagina geeft uitleg over het Gentoo Handboek en hoort de meeste van je vragen met betrekking tot het Handboek te beantwoorden. Te behandelen onderwerpen zijn het idee achter het handboek, de huidige status, toekomstplannen, hoe bug rapporten afgehandeld worden, etc.

We hebben ook handboeken welke de installatie instructies voor netwerkloze installaties met behulp van de installatie CD's bevatten. Als je geïnteresseerd bent in een netwerkloze installatie, lees dan het Gentoo Linux 2004.3 Handboek voor jouw architectuur. Deze is helaas in het Engels omdat we onvoldoende mankracht hebben.

Het doel van het Gentoo Handboek is om een samenhangend document te maken dat alle aspecten van Gentoo Linux beschrijft. Het voegt reeds bestaande handleidingen in een consistent boek zodat hetzelfde document voor iedere mogelijke systeem-architectuur, iedere installatie en iedere gebruiker gebruikt kan worden. Dit maakt het niet alleen makkelijker voor ons te onderhouden, maar ook voor de gebruiker om te zien dat de verschillen klein zijn, en dat andere systeem-architecturen niet als apparte hoofdstukken verschijnen.

Het stelt ons ook in staat om moelijke punten uit te leggen en meer voorbeelden te geven. We zijn niet gedwongen om alle documentatie in enkele pagina te laten zien zodat het document vloeiender loopt en leest.

Op dit moment is in het Engels het derde deel, Werken met Portage, af. Dit deel gaat diep in op de Portage aspecten. Deze is helaas nog niet in het Nederlands vertaald.

Indien je geïnteresseerd bent in het ontwikkelen van het Handboek, gebruik dan de gentoo-doc mailinglist (EN) voor feedback, of mail Sven Vermeulen direct.

Indien je geïnteresseerd bent in het vertalen van het Handboek of andere documentatie, gebruik dan de gentoo-doc-nl mailinglist.

Als je een bug in het handboek aantreft, bezoek dan alsjeblieft Gentoo Linux Bugzilla en creëer een bug voor Docs-user, Component Handbook. Bij voorkeur in het Engels. Als je een taalfout ontdekt, die alleen betrekking heeft op de Nederlandse vertaling, zet dan [dutch] voor de samenvatting of mail de gentoo-doc-nlmailinglist.

Alles is mogelijk, we hebben er echter voor gekozen dit niet te doen vanwege een aantal redenen.

Het onderhouden van zo'n handleiding zou veel moeilijker zijn. Niet alleen moeten we bij bug rapport terug zoeken welke keuzes gemaakt zijn (lang niet alle bug rapporten vertellen ons welke keuzes ze hebben gemaakt), maar het zou ook veel moeilijker zijn om de handleiding vloeiend te laten lopen; we moeten aandacht besteden aan de regel in het handboek, de consequentie, etc.

Hoewel we momenteel alleen de online versie hebben, worden andere formaten ontwikkeld, zoals een PDF versie. Als we een PDF maken voor elke architectuur en elke optie, dan zouden we veel PDFs hebben die slechts een beetje verschillen. Dit zou een verspilling van de beschikbare middelen zijn.

De keuzes die de gebruiker maakt worden op verschillende plekken gemaakt. Dit zou het moeilijker maken voor de gebruiker om het handboek te printen, we zouden hem/haar eerst moeten inlichten over alle keuzes voordat hij/zij kan beginnen. Dit schrikt enkel af.

Het deel over de "Gentoo installatie" is niet het enige deel van het Gentoo Handboek, wel het eerste. Alle navolgende delen zijn onafhankelijk van de keuzes die de gebruiker gemaakt heeft. Het dynamisch genereren van het handboek voor enkel de installatie instructies is overkill.

Door de instructies niet voor elke mogelijke optie te scheiden, kan de gebruiker zien wat het resultaat van zijn keuze is. Dit geeft een beter overzicht van de installatie instructies voor de gebruiker: zelfs nadat de gebruiker voor - bijvoorbeeld - stage3 gekozen heeft, kan deze nog makkelijk worden ingelicht over wat stage1 of stage2 doet. Deze instructies niet verbergen is een goed idee.

Raporteer alsjeblieft je idee; het ergens niet mee eens zijn zonder ons van opbouwende kritiek te voorzien verbetert de situatie niet. Documentatie is gemaakt voor de gemeenschap, dus feedback vanuit de gemeenschap wordt gewaardeerd.

Echter, je moet beseffen dat de meeste keuzes worden gemaakt tijdens de ontwikkeling van de documentatie op basis van de mening van de ontwikkelaars. Het is onmogelijk om documentatie op een manier te schrijven waar iedereen blij mee is. Je moet in staat zijn een "Nee" te accepteren met de reden dat wij er overtuigd van zijn dat de huidige implementatie de meeste mensen helpt.