Du nouveau sous le soleil de la documentation Gentoo

Posté par  . Modéré par Benoît Sibaud.
Étiquettes :
0
8
oct.
2004
Doc
Beaucoup s'accordent à dire que Gentoo[1] est un excellent projet, car très bien documenté (évidemment ce n'est pas le seul argument, mais il y contribue fortement). Notamment, les documentations officielles[2] sont fournies, et expliquent l'installation de la distribution, ainsi que son fonctionnement global (Portage, ebuilds, options USE, etc.).

Un site non officiel[3] existe également, qui permet de naviguer dans l'arbre de Portage, de faire des recherches de dépendance inverses, et quelques petits trucs assez intéressants. Thrasher (l'administrateur de tout ça) a eu également la bonne idée de créer un wiki[4] qui permettrait de rassembler des documentations non officielles sur la configuration, le fonctionnements, des FAQ, des pages de manuel, des petites astuces, etc.
Pourquoi faire ? En fait ce n'est pas pour s'affranchir du travail des documentalistes officiels, mais il y a des choses qui ne peuvent pas aller dans une documentation officielle (les trucs et astuces par exemple). D'où l'idée du wiki. Pour le remplir, rien de plus simple. Aller chercher à droite et à gauche ce qui a déjà été fait, obtenir les autorisations, et retranscrire. Écrire également des HOWTO dont on attendait la rédaction (voir la page "Wanted" par exemple), écrire des pages, simplement.
Et puis il a eu du succès. Maintenant il contient une quantité d'informations qui devient conséquente, et on y trouve de plus en plus de choses. En plus, si certaines sont vraiment orientées Gentoo, d'autres peuvent être utilisées quelque soit la distribution.

Notre cher administrateur a eu l'idée de proposer des versions dans d'autres langues. Je venais d'arriver, il m'a attrapé au vol, et voilà ce que ça commence à donner[5]. On est actuellement une poignée à avoir contribué (voir la liste des participants, ceux non inscrits ne sont pas nombreux à avoir participé).
D'ici peu, l'ensemble des HOWTOs du forum officiel de Gentoo[6] sera (si toutes les autorisations tombent) entièrement retranscrit. Un certain nombre de traductions ont déjà été faites. De très nombreuses restent à faire. Et des documentations inédites aussi, bien sûr.
Vous pouvez donc y jeter un oeil si vous voulez, si vous cherchez de la documentation.
Vous pouvez également nous aider, parce qu'on n'est pas nombreux, et le rythme actuel ne risque pas de tenir encore longtemps (études pour les uns, travail pour les autres, et pour moi études et autres projets en même temps), et que plus on est de fous, plus on rit :)
Pour le côté organisationnel, vous pouvez aller voir sur http://fr.gentoo-wiki.com/Désirés ainsi que sa page de discussion, c'est une première tentative d'organiser les choses, et pour l'instant elle fonctionne bien.

C'était ma petite publicité, je tenais à la faire, à un moment où le wiki commençait à être rempli, on a plus de 10 HOWTO, près de 10 trucs et astuces, et quelques articles de fond, il manque encore quelques pages de wiki, mais ça viendra, tout ne peut pas se faire en un jour, ni en un mois.

Aller plus loin

  • # c'est parfait.

    Posté par  . Évalué à 6.

    Je n'y aurai jamais pensé mais c'est juste LE truc qui manquait et qui en existant devient indispensable :
    j'y vois là le meilleur complément possible à la doc officielle et au forum, c'est juste parfait....Gentoo est une excellente réponse pour l'ignorant total qui est prêt à passer un peu de temps..
    merci Gentoo et à tout ceux qui la font vivre
  • # Cool

    Posté par  . Évalué à 9.

    c vrai c sympa et même plus.
    A noter je suis vachement content car mon premier ebuild (vrai le tout premier que j'ai fais et il y a pas lgtps) viens d'être intégré à l'arbre officiel, je suis vachement content, parce que là j'ai vraiment l'impression de participer plus encore à Gentoo, et donc je vais de ce pas voire comment participer de nouveau sur ce site non-officiel
    • [^] # Re: Cool

      Posté par  . Évalué à 1.

      Bravo !

      C'était quoi comme ebuild ?
      • [^] # Re: Cool

        Posté par  . Évalué à 5.

        qsa-1.1.1 dans dev-libs pour l'instant il est mis en ~x86 ~amd64, normal viens juste d'etre insérer mais c sur que cela marche sous les deux (j'ai les deux archi)

Suivre le flux des commentaires

Note : les commentaires appartiennent à celles et ceux qui les ont postés. Nous n’en sommes pas responsables.