Écrire un livre technique qui vieillit bien
Un livre technique a deux ennemis : l'erreur, qui le discrédite immédiatement, et l'obsolescence, qui le tue en dix-huit mois.
L'essentiel
- Deux ennemis : l'erreur, qui discrédite immédiatement, et l'obsolescence, qui tue en dix-huit mois.
- Séparer le durable du versionné permet de ne rééditer que la partie concernée.
- Sur un sujet technique, le lecteur vérifie en quelques secondes — l'exactitude n'est pas négociable.
- Le manuscrit reste modifiable chapitre par chapitre pour les rééditions.
Séparer le durable du versionné
Les principes durent, les versions passent. Un ouvrage qui mélange les deux se périme entièrement à la première mise à jour de l'outil décrit. Isoler ce qui dépend d'une version permet de ne rééditer que la partie concernée.
« Un ouvrage qui mélange principes et versions se périme entièrement à la première mise à jour de l'outil décrit. »
L'exactitude n'est pas négociable
Sur un sujet technique, une erreur se vérifie en quelques secondes par le lecteur. Les affirmations vérifiables sont analysées et les points sensibles signalés avant publication.
Le parcours, appliqué à votre cas
- 1
Cartographier durable et versionné
Les principes d'un côté, les versions de l'autre — isolés dès l'architecture.
- 2
Écrire vérifiable
Chaque affirmation technique est une affirmation qu'un lecteur peut contrôler.
- 3
Contrôler l'exactitude
Analyse des affirmations, signalement des points sensibles avant publication.
- 4
Prévoir la réédition
Chapitres modifiables et suivi des éditions successives.
Questions fréquentes
Peut-on rééditer facilement ?
Oui : le manuscrit reste modifiable chapitre par chapitre, avec un suivi des éditions successives.
Le code et les exemples sont-ils gérés ?
Les éléments techniques sont composés dans les fichiers finaux ; leur exactitude relève de la vérification, comme toute affirmation.
Votre sujet, en 3 étapes réelles.
Identité, persona, architecture — produits devant vous, sans compte.
EssayerÀ lire ensuite
Ne générez pas un ebook.
Produisez un livre.
Décrivez votre sujet : Book Intelligence construit l'identité, le persona et l'architecture de votre livre devant vous.