Comme le signale le post en dessous de totof2000, le plus simple est de s'alimenter sur la doc de la distribution...
Et de repondre le plus possible a un besoin specifique :
Howto Modem sera tres utile un informaticien mais le debutant sera noye sous l'information.. quelle page est pertinente pour son cas, etc..
Sur ubuntu-fr on essaie de faire ca au maximum, ex :http://doc.ubuntu-fr.org/materiel avec plus ou moins de succes (c'est un wiki avec autorisation en ecriture aussi pour les anonymes) des fois il faut deplacer une page et factoriser au maximum : sur une page de support d'une carte wifi non reconnue a l'installation il faut la lister dans ndiswrapper plutot que redetailler une enieme fois la l'installation de ce programme.
Mais c'est tres enrichissant, on voit passer des docs particulierement interessantes qui sont tres peu modifiees car completes, claires et repondant a un reel besoin.
A mon avis ca vient du deplacement de qualification des redacteurs de doc (le choix du wiki s'en trouve conforte) : avant le programmeur detaillait la doc de son programme avec toutes ses fonctions, en expliquant bien ses choix et de facon exhaustive. Avec l'arrivee d'un public plus large sous GNU/Linux pas mal de docs sont ecrites par les utilisateurs en precisant la ou eux avaient eu un soucis.
De fait on se retrouve avec :
- les howto du programmeur ou de l'equipe de programmation sur le site du programme, generalistes, exhaustives, detailles, indispensables pour les gens du metiers.
- les utilisations en situation reelle * avec des utilisateurs satisfaits de ces programmes
[^] # Re: ma référence francophone
Posté par Ju. . En réponse au journal La documentation sous linux. Évalué à 2.
Et de repondre le plus possible a un besoin specifique :
Howto Modem sera tres utile un informaticien mais le debutant sera noye sous l'information.. quelle page est pertinente pour son cas, etc..
Sur ubuntu-fr on essaie de faire ca au maximum, ex :http://doc.ubuntu-fr.org/materiel avec plus ou moins de succes (c'est un wiki avec autorisation en ecriture aussi pour les anonymes) des fois il faut deplacer une page et factoriser au maximum : sur une page de support d'une carte wifi non reconnue a l'installation il faut la lister dans ndiswrapper plutot que redetailler une enieme fois la l'installation de ce programme.
Mais c'est tres enrichissant, on voit passer des docs particulierement interessantes qui sont tres peu modifiees car completes, claires et repondant a un reel besoin.
A mon avis ca vient du deplacement de qualification des redacteurs de doc (le choix du wiki s'en trouve conforte) : avant le programmeur detaillait la doc de son programme avec toutes ses fonctions, en expliquant bien ses choix et de facon exhaustive. Avec l'arrivee d'un public plus large sous GNU/Linux pas mal de docs sont ecrites par les utilisateurs en precisant la ou eux avaient eu un soucis.
De fait on se retrouve avec :
- les howto du programmeur ou de l'equipe de programmation sur le site du programme, generalistes, exhaustives, detailles, indispensables pour les gens du metiers.
- les utilisations en situation reelle * avec des utilisateurs satisfaits de ces programmes
* sur les sites des distributions en particulier