Le manuel Gentoo est disponible dans les langues suivantes :
Bienvenue sur la page d'accueil du manuel Gentoo. Cette page contient quelques explications relatives à la production du manuel Gentoo et devrait répondre à la plupart des questions à son sujet. Vous trouverez ici les idées qui ont mené au manuel, son statut actuel, ses développements futurs, comment nous avertir d'un bogue, etc.
Actuellement, nous fournissons uniquement le manuel dans une version lisible en ligne ou imprimable, page par page ou en une seule page. La production de la documentation sous d'autres formats est à l'étude.
Format | Description | Architectures |
---|---|---|
Les manuels spécifiques qui accompagnent les sorties de nouveaux CD Gentoo sont
disponibles pour une installation sans connexion réseau. Veuillez consulter les
Pour des raisons purement historiques, des manuels d'anciennes versions sont
conservés depuis la version 2004.2. Pour obtenir un manuel complet sur une
seule page, veuillez ajouter
Versions | Architectures |
---|---|
Le but du manuel est de rassembler différents documents en un ensemble cohérent. Quelques guides ont déjà été intégrés de façon à présenter une information complète et cohérente pour chaque architecture, chaque installation et chaque utilisateur. Cela est non seulement plus facile à maintenir, mais montre aussi que les différences sont minimes et que toutes les architectures bénéficient d'un traitement équitable.
Cela nous permet également de mieux développer certains points délicats et de donner plus d'exemples. De plus, la documentation est plus agréable à lire que si elle était présentée en une seule page.
À l'heure actuelle, la quatrième partie du manuel qui traite de la
Si vous désirez participer à la rédaction du manuel, veuillez envoyer un
courriel en anglais sur la liste de diffusion
Si vous constatez une erreur dans le manuel, veuillez nous en avertir en
remplissant un rapport de bogue via notre interface
Tout est possible, mais nous avons choisi d'éviter cette voie pour diverses raisons.
La maintenance d'un tel guide serait très difficile. D'une part, il serait complexe de déterminer le contexte d'un rapport de bogue à cause des différents choix que l'utilisateur aurait faits. D'autre part, il serait aussi bien délicat de fournir un texte d'une lecture fluide à partir des différents segments de texte que cela impliquerait.
Bien que nous n'ayons en ce moment qu'un seul format,
Une autre raison est que les choix que doit faire l'utilisateur se trouvent à plusieurs endroits du manuel et il faudrait lui poser toutes les questions en une fois avant la production du manuel. Cela serait maladroit et effraierait probablement plus d'un utilisateur potentiel.
La partie qui traite de l'installation n'est pas la seule partie, c'est la première, mais toutes les parties suivantes seront identiques. Par conséquent, créer des manuels différents de façon dynamique serait un véritable gaspillage de ressources.
Enfin, en ne séparant pas les instructions qui correspondent à chaque choix, nous permettons à l'utilisateur de voir rapidement les résultats des autres choix possibles. Il a ainsi une meilleure perception des différentes options et de leurs conséquences.
Les installations à partir des stage1 et stage2 ne sont pas couvertes par ce
manuel. Veuillez consulter notre
N'hésitez pas à nous faire part de vos remarques, idées ou commentaires via
Notez que la plupart des décisions quant aux développements de la documentation
sont collégiales et qu'il est parfois