#1 Le 15/07/2011, à 18:45
- jmib55
Problème dans la documentation : version non précisée
Dans la documentation, on retrouve des informations relatives à de nombreuses versions de Ubuntu et pour un débutant qui désire installer Ubuntu (c'est mon cas) cela prête à confusion.
Je suggère de mettre en début de chaque page de la documentation un encart (une note) précisant pour quelle version de Ubuntu la doc a été écrite (ou de quel à quel version la procédure est applicable). Dans le corp du texte, il est toujours possible d'introduire des variantes mais cela évitera de chercher des fichiers ou des options qui n'existe pas.
Cela pourrait être un texte du style
NOTE: Cet article a été écrit en prenant Ubuntu 10.05 comme référence. Il est applicable dans sa majeure partie à toutes les version entre 8.04 et 10.04. Depuis Ubuntu 10.04, l'interface a fortement changé et donc quelques paragraphes ne sont plus d'actualité.
Hors ligne
#2 Le 16/07/2011, à 12:08
- Baronsed
Re : Problème dans la documentation : version non précisée
C'est peut-être une bonne idée, mais ça ferait beaucoup à chaque fois. Ça multiplierait la quantité de texte. Je propose une variante qui permettrait d'économiser en occupation de l'écran tout en obtenant en un coup d'oeil les mêmes informations : 
Bon... si on néglige mon talent pour le dessin informatique, bien sûr --'
EDIT : et on risque d'avoir des problèmes avec les daltoniens - blague à part.
Dernière modification par Baronsed (Le 16/07/2011, à 12:10)
Hors ligne
#3 Le 16/07/2011, à 13:50
- jmib55
Re : Problème dans la documentation : version non précisée
C'est effectivement plus court mais cela implique que le lecteur sache de quoi on parle et au début ce n'est pas le cas. C'est surtout à ce moment que c'est utile. Je réfléchis à une alternative en tre les 2 idées.
Hors ligne
#4 Le 17/07/2011, à 13:45
- Baronsed
Re : Problème dans la documentation : version non précisée
"Que le lecteur sache de quoi on parle"
Ce serait certes moins détaillé, mais...
- il y aurait une sorte de convention : au début de la doc, on expliquerait la signification précise de chaque élément de ce petit panneau (sachant qu'il est largement améliorable ^^ : c'était juste pour illustrer mon idée)
- rien n'interdit de faire quelque chose de plus précis, par exemple employer la marge à gauche pour travailler au paragraphe près.
Hors ligne
#5 Le 17/07/2011, à 15:16
- jilucorg
Re : Problème dans la documentation : version non précisée
Peux-tu citer un ou deux exemples de docs posant problème dans ton cas ?
jiluc.
––
Pour soutenir concrètement le logiciel libre : l'April ! http://www.april.org
Hors ligne
#6 Le 18/07/2011, à 15:27
- YannUbuntu
Re : Problème dans la documentation : version non précisée
Bonjour
ce systeme existe deja : en haut de chaque page "application" ou "tutoriel", il y a des tags. Normalement (si la page est bien redigee), il doit y avoir aussi les tags des versions d'Ubuntu (Lucid, Maverick, Natty) pour lesquelles la page est valide.
Exemples: regardez en haut des pages http://doc.ubuntu-fr.org/boot-repair et http://doc.ubuntu-fr.org/tutoriel/comme … aurer_grub
Si vous voyez une page sans tag de version, vous pouvez les rajoutez (si vous avez testé sur Natty par exemple, vous pouvez ajouter le tag "Natty"), ou bien le signaler en envoyant un email a la liste de Contributeurs de la Documentation ubuntu-fr : http://doc.ubuntu-fr.org/wiki/liste_dis … umentation
à consulter/améliorer: Guide du Débutant, Logiciels, Ecole, Travail, Maison
Hors ligne