Table ronde doc
De Wiki de la communauté Mandriva.
Sommaire |
Table ronde du 19 aout 2008
En premier lieu, ce sujet a été ouvert afin de communiquer la date et le lieu de la réunion et aussi de recueillir des idées. Ces idées sont listées ci-dessous. Certaines n'ont pas été abordés lors des 3 heures de discussions. Vous trouverez ce qui a été retenu ou rejeté par les personnes présentes que je remercie chaleuresement au passage pour leur dévouement.
Doc en général
- Cooker doc
- Autre sources de documentation (blogs...), perte de l'effort général ?
Le wiki
Améliorations graphiques du wiki
- Coloration des titres en bleu ?:
- avis général favorable , facile à mettre en place
- yoho souligne que l'équipe web de mandriva travaille sur une nouvelle charte graphique et qu'il serait donc urgent d'attendre la fin de ce travail avant d'entamer ce type de travail sur le wiki
- Ne pas oublier que cette tâche nécessite des droits sur le serveur qu'il faudra demander à l'IS team de Madnriva
- sélection d'un groupe d'icone, création de ces icones ?
- icones proposition du projet tango http://tango.freedesktop.org/index.php?title=Tango_Icon_Gallery&oldid=6095
- ofaurax souligne aussi qu'il serait utile de créer éventuellement des icones supplémentaires
- autres propositions sur la page de discussion
- TODO:Reste à mettre en action cette idée: qui veut faire le taf ? Quels icones choisir et pour quels parties du wiki ?...
- faut il plus de videos ?
- avis général: si possible, oui !
- Consensus cependant pour préférer les tutos à base de captures d'écran dans la mesure du possible pour différentes raisons dont notamment la facilité de mise à jour, la simplicité de réalisation et la possibilité de l'intégrer à un texte explicatif plus important
Extensions utiles
Liste des extensions basés sur le travail de Fredxx (http://wiki.mandriva.com/fr/Navigation_dans_le_Wiki)
- CategoryTree:
- <i>avis général favorable
- TODO: yoho s'est proposé pour l'installer sur la plateforme de test du wiki dev.wiki.mandriva.com. Merci !
- Hierarchy
- Cette extension semble intéressante, mais rien de planifié pour le moment.
- http://www.mediawiki.org/wiki/Extension:CategoryBreadcrumb position dans la navigation comme Logiciel > Télévision > TNT
- Non abordé
Pour une discussion des autres extensions proposées par Fredxx, voir la page http://wiki.mandriva.com/fr/Discuter:Am%C3%A9lioration_de_la_navigation_dans_le_Wiki
Organisation de pages
- Quelles catégories utiliser ?
- avis général: les catégories freedesktop (utilisées déjà pour l'organisation des menus) comme proposé par Fredxx
- Importance d'éviter une prolifération des catégories
- Importante d'éviter les catégories trop génériques telles que la catégorie "Logiciels" si ce n'est qu'en l'utilisant en tant que méta-catégorie
- TODO:
- Travail d'identification des catégories freedesktop pertinences.
- re-catégorisation des articles
- mise en place d'index ?: Ex elaboré par Spip; http://wiki.mandriva.com/fr/Utilisateur:Ad3fc7cd849e1b6a2f8fd225e85a7427 ,
- avis général favorable
- TODO:
- Dépend peut-être de la refonte des catégories utilisés auparavant ?
- Puis Création de ces pages "catégories" en suivant l'exemple du modèle élaboré par Spip
- On pourrait pas utiliser la notion de Portail pour différentier:
- la "Documentation officielle" (les manuels qui seraient proposer en téléchargement)
- de la documentation communautaire (le wiki fr actuel)
- De la documentatin pour Contributeurs/Développeurs
- avis général: pas très utile ! La doc développeur existe surtout sur le wiki anglais et la doc officielle pourrait être proposé en téléchargement sur 1 simple page
- ofaurax a évoqué la possibilité d'une moulinette permettant de transformer la doc officielle en syntaxe wiki pour l'importer dedans. Comme personne ne s'est dévoué pour l'écriture de cette moulinette, on reste sur l'idée d'une simple page de téléchargement pour la doc officielle. L'équipe mandriva est-elle prête à intégrer la doc officielle sur le wiki ?
retour d'utilisateurs
- mise en place d'une possibilité de notation du niveau (de technicité) des articles : * ** ***
- avis général: oui !
- TODO: Reste à identifier une solution (extension, modèle ou autre) permettant de faire cela
- Possibilité a l'utilisateur d'ajouter des commentaires sur la page du wiki (cf l'exemple de dokuwiki http://www.guidelinux.org/wiki/doku.php?id=fragmentation_des_disques :en bas, il y a la possibilité d'ajouter des commentaires.):
- avis général partagé !
- TODO
- poursuivre la réflexion sur l'utilité effective de cette fonctionnalité
- Identifier une solution technique permettant de faire cela. yoho a avancé l'idée de l'extension http://www.mediawiki.org/wiki/Extension:Inputbox#Box_types
- une autre solution partielle au problème serait de favoriser les retours sur la page discussion. On peut déjà mettre plus en valeur le fait que le compte du forum peut être utilisé pour le wiki dans la page créer son compte ou se connecter
lignes rédactionnelles ?
- que doit on mettre dans un article d'un logiciel X :
- install ?
- fonctionnalités ?
- avantages/inconv. ?
- utilisation du prog ?
- problemes typiques rencontrés
- illustration d'utilisation
- zone de liens
gimp blender firefox thunderbird lyX krita pour vous faire une idée des divers styles...
- avis général: Fredxx, roudoudou et Spip ont décidé de bosser sur la question en s'inspirant du travail initial de fredxx sur ce wiki (http://wiki.mandriva.com/fr/Lignes_directrices_de_publication_des_articles) et sur l'article de l'ancienne base de connaissances (http://club.mandriva.com/xwiki/bin/view/Cc/LignesDirectrices)
- TODO: Essayer d'avoir quelque chose de fini pour la prochaine réunion
Sujets Non traités ou trop peu traités
Lignes rédactionnelles ?
- Quelques préconisations stylistiques dans la rédaction: cf "how we read on line" http://www.slate.com/id/2193552/
- les prochains objectifs dans la redaction
- sur quoi se base t on pour écrire certains articles : boot.iso, one, free ?
- amelioration des liens internes
A voir http://wiki.mandriva.com/fr/Aspect_du_Wiki http://wiki.mandriva.com/fr/Navigation_dans_le_Wiki
Généralités
- Le wiki dans les autres langues doit-il suivre le wiki fr, y a t-il un potentiel de traducteur ?
- Comment amener des nouveaux contributeurs ? voir #2 paragraphe precedent.
>> Faut il améliorer l'interface pour participer à la redaction ?
- la mise en place de codes spécifiques est-elle trop ambitieuse vis à vis des moyens (humains) dont nous disposons ?
- Dans quelle mesure mdv est elle prete à s'investir
- Articulation de notre wiki avec les wiki des autres distros...
- Essayer de rédiger dans un article spécifique, les tâches de bases susceptibles d'être demandé à l'utilisateur à la lecteure d'un tuto ? (Editer un fichier, installer/supprimer un ou plusieurs logiciel, installer mandriva, passer sous root,...)
- séparation nette laptop/desktop et server
- Peut être un modèle : ceci concerne les laptops etc. ?

