FLOSS Manuals
FLOSS Manuals, ou FM, est une fondation sans but lucratif créée en 2006 et basée aux Pays-Bas. Son objectif est de remédier au défaut de documentation de qualité sur les logiciels libres. La méthode utilisée repose notamment sur l'usage d'un wiki (TWiki puis Booki et à présent Booktype) supportant le développement collaboratif de manuels sur les logiciels libres et sur la mise en place de booksprints qui rassemblent les collaborateurs au manuel dans un espace donné.
| Floss Manuals Foundation | |
| |
| Situation | |
|---|---|
| Création | Juillet 2006 |
| Type | fondation à but non lucratif |
| Siège | Amsterdam, Pays-Bas |
| Langue | Anglais, Français, Finlandais, Parsi, Néerlandais |
| Organisation | |
| Personnes clés | Adam Hyde, Elisa de Castro Guerra (FM francophone) |
| Organisations affiliées | Software Freedom Law Center |
| Site web | fr.flossmanuals.net |
Le fonctionnement d'un booksprint
Les booksprints mis en place par FlossManuals concentrent une petite équipe de 6 à 8 personnes qui vont travailler ensemble pendant une semaine, avec pour objectif de produire un livre imprimé le dernier jour de la semaine.
Un ou une facilitatrice s'occupe de rassembler les participants et les amène à travailler ensemble en proposant des lignes de fonctionnement et de structuration du travail. En plus des consignes éditoriales, il ou elle veille à utiliser le mieux possible le temps imparti en valorisant la complémentarité des compétences, et à maintenir un climat collégial en prévenant aussi la fatigue de chacun.
Pendant les trois premières heures de la rencontre, les participants élaborent la table des matières de l'ouvrage. Ils rédigent ensuite les différents chapitres du livre sur une plateforme wiki disponible en ligne. Les collaborateurs travaillent à partir de leur expérience d'utilisateur ou de formateurs, ainsi qu'à partir des manuels déjà existant dans d'autres langues, sous d'autres format et publiés sous licence libre.
La libre discussion entre les participants est largement encouragée pendant tout le booksprint afin de partager les connaissances et d'homogénéiser le manuel. Des contributeurs en ligne sont aussi conviés à participer à la rédaction du manuel et se joignent à la discussion sur le canal IRC #booksprint du réseau Freenode, dédié au projet de collaboration[1].
Facilitatrice et équipe de collaborateurs rassemblés pour un booksprint.
Proposition de table des matières d'un manuel.
Écran de FlossManuals lors du booksprint sur PureData
Équipe discutant lors d'un booksprint.
Outils
De 2008 à début 2011, les participants des booksprints liés à FlossManuals ont utilisé la plateforme éponyme, construite à partir de Twiki, un outil qui a surtout été pensé pour l'écriture de documentation de logiciels libres. En , une migration a débuté vers la plateforme multi-usage Booki. Cet outil développé par la fondation FlossManuals vise à faciliter l'autonomie des contributeurs, produire des manuels de meilleure qualité et permettre l'écriture collaborative de livres plus diversifiés.
Les réalisations
Tous les manuels sont téléchargeables sur site du projet en format HTML, en format PDF et en format EPUB (lisible sur les liseuses électroniques). En plus de la version anglophone, il existe une communauté francophone, farsi, finlandaise et hollandaise de rédaction de manuel dans leurs langues respectives. Toute la documentation ainsi produite est sous licence GPL.
En , on comptait en tout plus de 50 ouvrages rédigés selon cette méthode, toutes langues confondues.
Une fois publié, chaque manuel possède un mainteneur (comme chez Debian) qui s'occupe de la structure d'ensemble du manuel et se charge aussi d'aller chercher de nouveaux contributeurs. Pour assurer la qualité du manuel, les mises à jour ne seront apportées que lorsqu'une nouvelle version est publiable.
Plusieurs manuels sont aussi produits en version papier, comme le montre l'exemple ci-joint.
Notes et références
- (en) « IRC », sur FLOSS manuals
Liens externes
- FLOSS Manuals English Homepage
- FLOSS Manuals Page d'accueil francophone
- Write Manuals
- Adam Hyde: Free Manuals for free software. Talk at Wikimania 2007, Taipei. Abstract