Skip to content

Latest commit

 

History

History
143 lines (104 loc) · 6.2 KB

BookSprint.md

File metadata and controls

143 lines (104 loc) · 6.2 KB

BookSprint

Version de travail en cours de rédaction

Cette recette décrit comment créer un livre de documentation en 5 jours.

Un booksprint est un format innovant basé sur le Code Sprint, mais en mettant l'accent sur la production de documents au lieu de code. Un sprint rassemble un groupe d'auteurs, d'éditeurs, d'artiste, de formateur connaisseur sur le sujet du livre pour aller du synopsis au livre publié en cinq jours.

Un booksprint c'est une autre manière d'éditer un livre en répondant différemment aux questions de qui écrit, qui fait les choix, qui édite, qui est légitime à produire des livres aujourd'hui.

C'est un mode d'édition collaborative et collective basée sur l'organisation d'un groupe de personnes autour d'un sujet commun. Le travail d'écriture est organisé à partir de méthodes dites « collaboratives » qui s'inspirent des méthodes AGILES et qui utilisent des outils de collaboration comme des PAD ou des espaces d'édition en ligne, des tableaux de suivi de la production des articles, des todolists ... Le groupe est animé par un-e facilitateur-trice.

L'édition s'y fait par un travail collectif, dans un temps et un espace donné, dans une itération entre écriture et relecture collective. Le format privilégié pour le booksprint est d'une semaine et une dizaine de participants. C'est un mode d'édition libre, de la même manière que sont construits des logiciels libres. Ce sont des éditions évolutives, enrichies par la communauté.

Ingrédients

  • 3-5 jours: 5 jours d'écriture pour une création, 4 pour une traduction, 1 jours réservés au déplacement si les co-auteurs voyagent de loin.
  • 3-14 personnes ayant des qualités rédactionelles (dans l'idéal, des personnes formatricess sur le sujet, ou des blogueurs, ou des chargés de documentation du sujet etc). Les personnes ont des connaissances différentes sur le sujet : expert, intermédiaire, débutant. Ces niveaux d'approches différentes sont très importantes ! Ex : 4 experts, 2 intermédiaires, 2 débutants.(ça marche mieux si tout le monde est réunis au même endroit, au même moment)
  • 1 facilitateur: gardien de la méthodologie et de l'organisation.
  • 1 objectif: écrire une documentation pour répondre aux besoins des utilisateurs.
  • 1 lieu
  • 1 ordinateur portable par personne.
  • 1 vidéo-projecteur
  • Une salle disponible 24h/24 avec internet ayant un débit suffisant
  • Outils Collaboratifs (mindmap, etherpad, ...)
  • Budget financier pour rembourser au minimum les coûts de déplacement et au mieux pour indemniser les co-auteurs.

Principes

Analyse des besoins des différents profils

  • Traducteurs
  • Administrateurs
  • Mainteneurs
  • Outils Collaboratifs
  • Documentation
  • Développeurs
  • Patch
  • Bug report
  • Utilisateurs
  • Célébrités
  • ...

Organisation de livre

Moyenne de 150-200 pages par livre. Aller du plus simple au plus compliqué. Sommaire Chapitre sections sections Chapitre sections sections

Roles tournants: tout le monde joue ces roles alternativement.

  • auteur: ecrire selon son expérience, ses connaissances, son savoir-faire en se référant à la discussion du groupe.
  • relecteur: verifier tester, completer, reformuler, réordonner, hierarchiser le contenu du chapitre ou de la section, déplacer du contenu, corriger les erreurs de sens, de code, chasser les incohérences
  • illustrateur: imager le livre
  • editeur: chasse au fautes d'orthographe, améliorer le style, homogéneiser les styles

Au dela du livre

A chque booksprint il n'y a pas du travail que sur le livre, mais on va essayer aussi d'apporter au projet (traduction, templates, correction de bugs …)

Déroulé

Démarrage

  1. Identifier les participants -> experts, intermédiaire, débutants
  2. Identifier les compétences complémentaires -> modeleurs, animateur, game designer, illustrateur, codeur, rigger … Intéressant d'avoir un developpeur participant aux projet qui peut fixer des bugs détectés au cours du sprint ou ajouter des modules
  3. privilegier libristes
  4. equipe mixte
  5. disponilité
  6. esprit collaboratif

Jour 1

Matin

  • présentation objectifs
  • présentation de tout le monde
  • definition des personnas
  • table de matières (fait par débutants)

Outils Carte heuristique (freemind) Dessins (facilitateur)

Aprem

  • création de 39 chapitres
  • chacun choisit le chapitre sur lequel il veut écrire
  • Chaque chapitre est écrit par 2 personnes et relus par 2 autres personnes

Jour 2 Redaction

Redaction des chapitres

Jour 3 redaction

jour 4 relecture

Jour 5 correction,

publication du livre le dernier jour à 18h.

Publier le livre

A utiliser en HTML, s'exporte en PDf grâce à Objavi, en ePub... Support aussi bien numérique que physique (livre papier).

Créer un Epub

Astuces pour bien réussir un Booksprint:

  • Offrir hebergement, voyage et un repas
  • indemniser tout le monde
  • Objectif clair
  • Tout le monde présent les 5 jours
  • Héberger tout le monde ensemble, manger ensemble ou activité de groupe
  • tout le monde décide ensemble
  • offrir café et thé
  • super équipe
  • gens qui savent collaborer

Variantes possibles

Un BookSprint n'est pas seulement le déplacement physique de 9 personnes, cela peut être un BookSprint ramassé dans le temps et élargi dans l'espace. Ex : une journée de BookSprint à 40. ou 10 soirs de Booksprint par mois en ligne de chez nous à des heures communes.

Les communications instantanées permettent de travailler ensemble sur Floss Manuals pour collaborer sur un même livre en même temps.

Mais le travail en simultané dans un même lieu reste plus efficace.

Source:

Elisa de Castro Guerra, Cedric Gémy, Nicolas Dufour et FLOSS MANUAL FR. Adapté de la méthode initiallement développée par Adam Hyde et Thomas Kraag.

Liens

Licence

CC-BY-SA