elanceur - Qu'est-ce qu'un Wiki ? (Et Comment l'Utiliser pour Un De Vos Projets)

Publié initialement sur O'Reilly Network (http://www.oreillynet.com/)
Le lien original est le seul lien de référence
par Tom Stafford, Matt Webb

Copyright © 2006 O'Reilly Media, Inc.

Wiki

Un wiki est un site web où les utilisateurs peuvent ajouter, retirer et éditer chaque page en utilisant un navigateur web. C'est tellement facile pour les personnes de s'engouffrer dedans et de réviser des pages que les wikis sont en train de devenir l'outil de choix pour les gros projets avec de nombreux participants.

Dans cet Article :

Quelque part dans une salle de classe faiblement éclairée, une étagère de bibliothèque ou dans un bureau à domicile, un type un peu chanceux est en train d'écrire un roman à partir de rien sans aucune notes. Cet individu inspiré est capable d'ébaucher des sections complètes sans oublier à la fin quelle section sera destinée à être incluse au début et peut faire émerger un argument soigneusement rythmé avec des idées et références assemblées sur une période de quelques mois, toutes parfaitement réassemblées. Aucun de vos auteurs n'est cette personne. Au lieu de cela, nous avons besoin d'aide et cette aide entre dans le façonnage d'un wiki.

Un wiki est un site web où chaque page peut être éditée dans un navigateur web, par quiconque survient pour la lire. C'est si facile pour les personnes de sauter dedans et de réviser des pages que les wikis sont en train de devenir connus pour être l'outil de choix pour de gros projets avec beaucoup de participants. Ce tutoriel traite de la façon d'utiliser efficacement un wiki pour garder des notes et partager des idées parmi un groupe de personnes et comment organiser ce wwiki pour éviter de perdre des idées et encourager la sérendipité.

Les Wikis Fonctionnent Pour de Gros Projets

Cet article a été écrit en utilisant un wiki, comme l'ont été la plupart des 100 hacks dans notre livre, Mind Hacks. Le premier exemple d'un wiki en action est Wikipedia, l'encyclopédie open source. Wikipedia est l'une des meilleures ressources sur l'internet, et sa qualité et son étendue accordent une reconnaissance au fait que wiki soit un outil génial. Mais cela ne fait qu'illustrer simplement une façon d'utiliser le wiki.

Wikipedia se construit sur la transparence, le lien simple et une faible barrière à l'entrée pour que des masses de personnes puissent s'impliquer dans l'édition et la publication. Nous pouvons utiliser ces mêmes qualités avec juste deux ou trois personnes pour une production différente : un espace de travail partagé et par effet une mémoire partagée.

Comme avec n'importe quel projet, nous avons trouvé qu'un livre était trop gros pour tenir dans la tête en une seule fois, et définitivement trop gros pour garantir de se souvenir de beaucoup d'idées prometteuses qui surviennent aux moment ou nous étions le moins capables de les suivre. Quelques-unes de ces idées démarreraient comme des pensées brutes à l'improviste et puis une fois relancées, grandiraient pour changer des grosses parties de notre concept majeur. Aussi était-il important de les enregistrer et de leur donner un espace. Un bon nombre d'idées enregistrées veut dire bien sûr qu'il est facile de ne plus être synchronisé avec les partenaires du projet et c'est là où le wiki en tant que mémoire partagée entre en scène. Utiliser un wiki pour vos gros projets maintient tous les participants sur la même page.

Ce que C'est que d'Utiliser un Wiki

Avant de voir comment choisir le bon wiki pour vous et les astuces générales pour en utiliser un, il peut être utile de savoir comment nous avons utilisé un wiki pour notre propre projet. L'écriture de Mind Hacks nous a obligé à passer par différentes étapes de travail : d'abord nous avons dû déterminer quels seraient les hacks, et cela tendait à sortir de la recherche sur d'autres hacks, des suggestions ou de la relance d'idées existantes. Ensuite est venu l'assemblage du contenu et un article sur le hack était ou non trouvé. La dernière étape amènerait à rédiger la version préliminaire, mettre encore plus d'ébauche et pour finir publier.

Lecture en Rapport

Mind Hacks
Tips & Tricks for Using Your Brain
de Tom Stafford, Matt Webb

Table des Matières
Index

Lire en ligne--Safari Cherchez ce livre sur Safari :

Quelque chose que nous avons souvent constaté : durant la recherche, nous avons découvert plein de petits faits. Nous les avons classés sur des pages déjà dédiées aux hacks ou aux hacks potentiels. Plus tard, quand nous en sommes venus à les écrire, nous avons trouvé les notes que nous avions enregistrées mais oubliées, et l'écriture a été meilleure. Souvent, l'un de nous faisait une note et l'autre venait la croiser et en savait plus à ce sujet.

Le fait que l'ensemble du livre ait été écrit sur notre wiki privé, il a bénéficié de ces idées que nous pouvions saisir sans casser le rythme -- en fait, c'était juste l'édition facile qu'un wiki fournit qui nous a permis d'enregistrer ces idées. Si cela avait été plus difficile, nous n'aurions pas voulu faire une pause tout en écrivant un hack pour jeter les idées sur un autre.

Mais nous avons aussi bénéficié parce que le wiki a supprimé les temps de traitement administratifs : nos réunions ont été plus faciles pace que nous connaissions nos progrès et nos actions (nous avions une todo.txt). Nous pouvions en toute confiance poster des comptes-rendus sur le wiki parce que nous savions qu'ils ne seraient pas perdus. Nos idées à propos de la forme ultime du livre étaient continuellement affichées -- et partagées -- ainsi nous n'avons pas été obligés de passer du temps à parler de ça durant les réunions. Il y a une phrase à propos des wikis : "Ce que vous pensez est ce que vous obtenez." Un wiki est une mémoire couchée par écrit avec beaucoup plus d'espace que celle intégrée et c'est aussi une mémoire collective.

Choisir un Wiki

Il pourrait sembler que choisir le bon logiciel dépend du type de projet que vous avez planifié, mais choisir quel wiki utiliser dépend d'abord et surtout de ce que votre serveur web supporte déjà. Nous vous donnerons quelques points de départs sur les endroits où les trouver et les manières de choisir quelq wiki installer et aussi ceux que nous aimons.

"Which Open Source Wiki Works For You?" (O'Reilly Network) peut être désormais un peu daté (il a été écrit en 2004) mais l'article est encore un grand point de départ et il évalue des wikis en se basant sur des critères importants. Une lecture rapide de cet article peut vous donner une bonne idée sur la manière de choisir votre wiki.
Wikipedia a une "Comparison of Wiki Software" qui inclut les logiciels commerciaux et hébergés. C'est un aperçu compréhensible et facile à lire.
WikiMatrix mérite une mention spéciale. Il héberge de l'information sur une grande sélection de logiciel wiki, et vous laisse jouer avec des comparaisons mises côte à côte selon les critères allant des exigences systèmes jusqu'à la syntaxe wiki. Ceci est génial quand vous finalisez votre choix. Il n'y a néanmoins pas d'évaluation pour connaître la facilité d'installation d'un moteur. Vous devrez vous référer à l'article de comparaison de Wikipedia pour cela, et il est conseillé de lire la documentation d'installation du logiciel avant que vous ne vous engagiez dedans.

Ainsi, que devriez vous regarder ? Révélation totale ici : nous avons utilisé MoinMoin pour écrire Mind Hacks et en avons été vraiment très satisfaits (il a même eu une mention dans le livre). Ce n'est pas le seul logiciel wiki que nous avons utilisé, mais il a très bien tenu face aux points d'évaluation listés plus bas. L'installation et la mise à jour de version en version peut présenter un petit degré de difficulté pour un débutant avec la ligne de commande, mais devrait être raisonnablement simple pour ceux ayant quelque connaissance.

Les critères pour évaluer le wiki à utiliser :

Facilité d'installation.
Comptes utilisateurs (ainsi votre nom est attaché à toutes les modifications que vous produisez).
Abonnement à une modification de Page par email et RSS.
Historique de page et révisions archivées (tous les wikis n'ont pas ça, mais ce peut être une fonctionnalité importante).
Documents en pièces-jointes.
Verrouillage de l'édition de page (vous ne voulez pas que deux personnes éditent une page en même temps, parce qu'une perdra ses modifications)
Un syntaxe facile à retenir.

Quelque chose dont vous n'avez pas nécessairement besoin est d'un logiciel wiki qui soit beau. Souvenez-vous que c'est pour organiser votre projet, pas pour produire des pages suffisamment belles pour l'impression. Quelques logiciels wiki sacrifient la syntaxe simple pour un contrôle total sur la mise en page -- ne vous préoccupez pas de ça.

Checklist

Bien, vous avez installé votre wiki et vous êtes fixé sur cette page d'accueil par défaut ? Que se passe t'il maintenant ? Nous irons plus tard dans le rationnel, mais pour le moment vous pouvez décrocher pour un démarrage rapide en suivant ces étapes suivantes :

Configurez-le : Verrouillez-le de façon que personne ne puisse le voir, ou ne dites simplement à personne son adresse. Puis, faites-vous un compte utilisateur sur le wiki de façon à ce que vous puissiez dire quelles pages vous avez éditées et quand. Et assurez-vous de vous abonnez aux modifications sur toutes les pages. Si vous utilisez RSS, regardez s'il y a un fil RSS pour les "Modifications Récentes" et ajoutez-le à votre lecteur de nouvelles. S'il n'y en a pas, abonnez-vous par email à toutes les pages. (Truc : si vous utilisez MoinMoin et qu'il vous demander une expression régulière pour correspondre aux titres de pages, saisissez ".*".)
Créez un layout de démarrage : Divisez votre projet en cours dans des sous-projets auto-contenus, et donnez leur à chacun des titres de pages en style WikiMots. Nous avons utilisé "AllHacks". Vous pourriez utiliser "ToutesLesTâches". Ceci est le premier lien que vous devriez ajouter à la page d'accueil de votre nouveau wiki. Quand vous nettoyez la page d'accueil, mettez tout le texte par défaut en bas (vous pourriez en avoir besoin plus tard) et faites un espace en haut pour vos liens communs et tâches en cours.
Démarrez avec ces bonnes habitudes : Vous voudriez vous donner à vous même chaque opportunité d'utiliser le wiki sur une base régulière. Tirez les liens de la page d'accueil et des Modifications Récentes dans la barre de signets de votre navigateur. Déterminez vos tâches quotidiennes (ou celles de la semaine) pour vous et vos collaborateurs et listez-les sur le wiki comme "ToDoPour27Juillet" (ou ce que vous voulez). Ajoutez cela aussi à la page d'accueil et soyez sûr d'ajouter des noms wiki pour chaque item auquel vous pourrez faire référence plus tard. Pour finir, prenez dix minutes par jour pour jardiner le wiki, mais ne spécifiez pas n'importe quelle tâche particulière à l'avance sur le temps. Prenez un café puis parcourez simplement et effacez vos emails de mise à jour, et lisez ce que vous devez encore faire à partir de la liste "ToutesLesTâches". Suivez quelques liens et faites tout ce qui vous semble nécessaire pour garder les choses propres. Après dix minutes, arrêtez-vous simplement. C'est ça l'essence du jardinage wiki.

Avantages à Utiliser un Wiki

Pourquoi pourriez-vous utiliser un wiki pour votre projet ? Le wiki est :

Bien pour écrire des idées rapides ou des plus longues, vous donner plus de temps pour une écriture formelle et la publication.
Collaborer instantanément sans emailer de documents, et maintenir le groupe en synchronisation.
Accessible à partir de n'importe où avec une connexion web (si vous ne vous souciez pas d'écrire dans des formulaires texte dans le navigateur web).
Votre archive, parce que chaque révision de page est conservée.
Excitant, immédiat et donneur de pouvoir -- tout le monde a une opinion.

Inconvénients à Utiliser un Wiki

Bien, vous avez l'idée : nous aimons utiliser les wikis. Mais pourquoi pourriez-vous ne pas vouloir en utiliser un ?

Le linge sale n'est pas une belle vitrine publique. Si un wiki est une mémoire partagée, il va être très propre, et vous pourriez ne pas vouloir que les personnes voient vos idées à moitié formées, non sûres et spéculatives (même si véritablement, nous recommandons de ne pas mettre votre wiki en public)
Sa tendance à être de plus en plus fouillis. Un wiki n'est pas une panacée administrative et il y a une certaine maintenance que vous devrez produire, autrement il se transformera en une soupe d'idées inutilisable.
Son abominable système de gestion de contenu. Vous devrez courir après vos propres standards pour la mise en page et quand ce sera le temps de migrer votre format de document final, il y aura plus de travail.
Si vous avez un wiki public avec l'édition ouverte, vous aurez besoin de le surveiller pour éviter les batailles improductives des utilisateurs sur le contenu.
Il n'est pas si bien pour les non-geeks, parce que vous avez besoin d'être raisonnablement fûté en technique et à l'aise avec le concept de la syntaxe texte.
QuelquesPersonnesDétestentLaCasseChatMot.
Ce n'est pas évident d'installer ou de sauvegarder votre logiciel wiki.

Utiliser un Wiki

Compte tenu des pour et des contre, nous dirions que votre projet pourrait utiliser un wiki s'il n'y a pas trop de participation de votre part, si vous n'avez pas besoin de travailler en public, si vous pouvez faire tout ou la plupart du travail sur le wiki (l'exposition constante est importante) et si votre projet est vraiment gros.

Ceci étant dit, il y a quelques trucs spécifiques quand vous aurez décidé que vous êtes prêt pour plonger dans le monde wiki :

Gardez toutes vos notes sur le wiki ! Ne faites pas que la page wiki soit trop stressante à éditer. Si vous devez écrire un titre, ou une date ou vos initiales, ou même si vous gardez les choses propres quand vous produisez une note -- vous pourriez ne pas le faire. Si vous avez une idée, vous voulez pouvoir cliquez sur Editer, la noter en bas et fermer la fenêtre. Dans cet esprit, conservez un lien permanent dans la barre d'outils de votre navigateur.
Utilisez les pièces jointes. Utilisez beaucoup de pièces jointes, copiez les PDFs et les images quand vous le pouvez, et conservez beaucoup de références et de liens sur le wiki. Ne conservez aucun de vos contenus de support sur votre ordinateur.
Tout cela parle de s'habituer aux wiki. Utilisez partout des MotsWiki. Nous avons mis tous nos titres d'aricles en CasseTitreWiki jusqu'à ce que nous soyons forcés à leur donner des titres propres. Ceci voulait dire que nous connaissions la façon d'utiliser wiki et pouvions produire des notes sur papier qui pouvaiênt facilement réconciliées plus tard avec le wiki.
Ne soyez pas coincé d'utiliser le wiki pour la collaboration. Oui, tout devrait vivre là, mais n'essayez pas de travailler sur la même page le même jour. Vous avez une bonne compréhension de ce qu'il y a et où, et cela veut dire que rien ne change sous vos pieds. Parlez au personnes de choisir des sujets. Si vous travaillez activement sur le même document, divisez-le en quelques pages.
Si vous avez besoin de partir du wiki pour terminer ce que vous êtes en train de travailler, c'est bien aussi : oui un wiki est bien pour la collaboration, mais il est plus important d'avoir une mémoire partagée qu'un espace de travail partagé. Si vous avez besoin de travailler en dehors du wiki -- dans un document Word avec les Suivis de Révisions branchés, ou de jeter un fichier texte dans l'email -- faites ça. Utilisez le wiki quand cela réduit votre charge de travail. Vous n'avez pas besoin d'être strict parmi un tout petit nombre de personnes. Les wikis parviennent à être bien pour la collaboartion, mais le point sur lequel ils sont vraiment bien est d'être un espace où il est vraiment facile d'écrire des choses et de les retrouver à nouveau.

Trucs d'Organisation Wiki

Maintenant vous êtes engagé avec votre wiki ; voilà quelques trucs pour rester organisé, qui amèneront à une expérience wiki heureuse et réussie.

Maintenez un index : Si le wiki est fortement structuré avec des pages que vous ne pouvez seulement obtenir que par un clic-clic et clic, vous ne trouvez jamais rien. Nous avons maintenu une page unique appelé "AllHacks," listant tous les hacks et les hacks potentiels. Ceux-ci ont été organisés dans le même ordre que le livre, et une note produite autour de chacun d'eux selon son statut. Du fait qu'ils figuraient tous sur la même page, il était facile d'avoir une exploration rapide. Souvenez-vous, vous voudriez penser, "Oh, qu'est ce qu'était cette idée une fois de plus ?" et trouver vous-même en cliquant sur le lien, en lisant rapidement, et en cliquant sur Retour sans l'avoir vraiment même remarqué. Gardez la navigation simple.
Gardez le fouillis : La dimension temporaire est clé -- ne laissez pas le perfectionnisme s'installer, allez dans le sens de jeter sur le wiki des demi-idées, des graines potentielles et des faits dont vous aurez besoin plus tard.
Mais pas trop fouillis : Nous avons parlé plus tôt du "jardinage wiki", qui est le processus de se promener sur le wiki et de le nettoyer au fil de votre chemin. L'objectif n'est pas nécessairement de nettoyer, c'est aussi voir les pages et les idées avec un oeil neuf. C'est une bonne habitude, c'est facile et ne devrait vous prendre simplement que dix minutes par jour -- c'est continuel. Essayez de passer le temps de votre première tasse de café le matin sur le wiki, pour reprendre quelques conclusions un peu lâches, nettoyer l'index et ainsi de suite. Faites plus à chaque fois que vous avez quelques minutes. Vous traverserez des idées jetées tard dans la nuit avant qu'elles ne puissent être changées un autre jour. Soyez prudent néanmoins de ne pas imposer une structure trop tôt. Vous en viendrez à une compréhension, au fil de votre jardinage, de ce qui a besoin d'être structuré et ce qui n'en a pas besoin. La réorganisation (mais pas trop) garde les choses fraîches.
Ne soyez pas effrayé des synonymes : Disposer de beaucoup de pages traitant de la même chose n'est pas mauvais si cela signifie que vous produisez plus de notes. Mais gardez toutes ces pages liées sur votre table des matières de façon à ce qu'elles puissent être jardinées et réorganisées ailleurs plus tard. En fait, il est bon d'avoir beaucoup de textes et de synonymes sur une page parce qu'il est fort probable que vous les retrouverez plus tard avec une recherche texte.
Faites des notes dépendantes du contexte : Conservez les notes à l'endroit où vous pensez que vous pourrez les faire avancer plus tard. C'est un peu comme accrocher une note "acheter du lait" sur la porte d'entrée où vous la verrez dès que vous sortez au lieu de la mettre sur le réfrigérateur où vous ne la trouverez que juste après avoir fait bouillir la théière. Ou comme mettre votre passeport dans vos chaussures de façon que vous ne puissiez pas partir sans l'avoir pris. Posez des notes partout, mais posez les notes ensemble sur des pages avec d'autres notes. Souvenez-vous que l'intention est que quand vous en venez à véritablement écrire un article complet, vous courez à travers les choses que vous avez oubliées et pouvez les utiliser pour améliorer votre article.

Trucs de Partage Wiki

Le wiki est un espace commun dans votre groupe, aussi voici quelques règles-maison suggérées pour vous aider à progresser :

Immersion totale : Chaque édition devrait vous être envoyée par e-mail, et utilisez les MotsWiki même dans la correspondane privée. Nous avons réglé notre wiki pour qu'il envoie un email à chaque fois qu'une page est mise à jour (la plupart des wikis ont une page de Modifications Récentes à laquelle vous pouvez vous abonner.) Cela peut sembler excessif, mais ce ne l'est vraiment pas ! Nous pourrions lire la ligne de sujet du wiki et effacer le mail. En faisant ça, scanner simplement votre boîte de courrier entrant vous donne un bon niveau d'historique de ce qui a changé et où. (Si vous êtes un chasseur RSS, vous pouvez vous abonner en utilisant un fil à la place.)
Commentaire in situ : Sentez-vous libre de faire des commentaires sur les idées de quelqu'un d'autre et d'écire sur la même page -- peut-être même dans le même paragraphe. Vous trouverez un standard pour commenter l'un à l'autre (utiliser peut-être du gras, peut-être ou utilisez des crochets avec votre nom). Faire cela garde ensemble les conversations en dehors du workflow immédia, où ils peuvent continuer à leurs propres rythmes sans interrompre tout travail urgent. C'est aussi un incentive de suivre de près l'abonnement par email aux Modifications Récentes. Sur ces mêmes lignes, assurez-vous de vous connecter au wiki et d'avoir un nom d'utilisateur ayant du sens. Si vous n'utilisez pas cela pour voir qui a fait quoi, vous oublierez.
Ne partagez pas trop : Conservez ce wiki privé. La vie est trop courte pour devoir être conscient de ce que le public fait dans votre espace. Pensez à cela comme un bureau partagé où tout est là où vous l'avez laissé et où vous êtes habitué à la présence de chacun des autres -- ce serait ennuyeux d'arriver le matin et de trouver les livres sur vos étagères rangés par ordre alphabétique quand ils sont utilisés pour être dans un ordre pour un accès facile. Mettez un mot de passe sur votre wiki.
Soyez non-précieux : Le logiciel wiki vous aide à avancer votre propre écriture et ne pas vous sentir précieux à son propos, il vous donne la pratique pour faire que les idées sortent de votre tête pour être mises en mots (parce que le niveau de pression est bas). Ces deux composantes sont essentielles pour un projet collaboratif réussi et ce peut être difficile à apprendre. Souvenez-vous : sentez-vous libre d'éditer les pages de vos collègues et sentez vous flatté quand ils aident à éditer les vôtres -- même s'ils effacent tous vos mots et les récrivent complètement. Ce peut être douloureux au départ, mais cela concerne le projet, pas vous.
Soyez précis : Le jardinage et la facilité d'édition ne veulent pas dire que ce devrait être de mauvais qualité ou bâclé -- pour un partage efficace, vous voulez que vos collaborateurs sachent exactement ce que vous voulez dire. Regardez votre orthographe et votre grammaire, soyez clair, et ne vous attendez pas à ce que quiconque passe nettoyer après vous. Ceci est vrai pour la collaboration en général, mais quand vous ne partagez pas physiquement le même espace, il est plus important d'être conscient de ce que vous faites.

Trucs Techniques

Tout ne concerne pas l'écriture et comment progresser. Nous avons quelques trucs pour quiconque sera aussi responsable du côté technique du wiki :

Sauvegardez toujours : Si vous êtes un hacker, considérez d'installer le logiciel wiki sur votre portable et utilisez périodiquement rsync pour en faire une copie. Vous aurez une copie locale de référence, et un backup à remettre sur le serveur en cas de problème.
Ne mettez jamais à niveau : Ne mettez jamais à niveau votre logiciel wiki à mi-parcours sur votre projet, même si vous pensez que vous avez besoin d'une fonctionnalité supplémentaire. Il est trop facile de se faire dévier dans la mise à jour et la mise à niveau. Ce n'est pas à propos du wiki, cela concerne le projet.
Choisissez méticuleusement : Le logiciel wiki est facteur énorme pour faire que votre travail quotidien sera agréable et productif. Souvenez-vous de vérifier le moteur contre les critères d'évaluation donnés au-dessus, en prêtant une attention particulière aux historiques de page, aux comptes utilisateur et aux pièces-jointes. Pouvoir s'abonner aux modifications par email (ou RSS) est un must.

Conclusion

Les wikis sont à leur meilleur niveau quand un petit nombre de personnes travaillent intensément sur du contenu en rapport. C'est une moyen fouillis, immédiat et puissant de partager un espace d'idées avec vos collaborateurs.

Une fois que vous aurez utilisé un wiki pour un projet, vous trouverez qu'il sera difficile de revenir en arrière avec des méthodes traditionnelles. Vous vous retrouverez vous-même à utiliser des MotsWiki dans la conversation. Utiliser le wiki comme votre carnet de notes vous garantira que vous ne perdez pas les fils des bonnes idées, et passer du temps à naviguer et jardiner maintendra ces idées quand vous aurez besoin d'elles. Et surtout, vous trouverez qu'avoir une mémoire partagée sur un grand projet retire les administrivia et vous laisse vous concentrer sur le vrai travail.

Tom Stafford a un PhD en Cognitive Neuroscience et est actuellement associé au Département de Psychology à l'Université de Sheffield. C'est aussi un rédacteur associé du magazine et il a auparavant travaillé comme rédacteur freelance et chercheur pour la BBC.

L'expérience de Matt Webb est dans les nouveaux médias. Son job actuel à la R&D à la BBC couvre ces types de projets en interne, et cela lui donne de l'expérience pour rsoudre des idées sociales et technologiques à des publics mixés. Matt a été aussi un conférencier populaire à la Conférence sur les Technologies Emergentes de O'Reilly en 2004.

Bookmarkez cet article avec del.icio.us