Refonte de la documentation – Tex

La documentation technique devient difficile à gérer dans son ensemble sur une seule page dans un blog. C’était beaucoup plus facile avant dans un wiki parce que l’on pouvait éditer toute la partie d’un gros chapitre comme on pouvait n’éditer que la petite partie d’un chapitre de troisième niveau ou plus. De plus le wiki permet naturellement de remonter l’historique des versions et de montrer les modifications entre versions.

Cependant, il est dommage d’utiliser un wiki juste pour une seule grosse page, et pas forcément recommandé au delà d’une certaine taille.

La rédaction de cet unique document sous Tex semble plus adaptée. Il est possible de scinder les chapitres en fichiers distincts et de faire des exports dans différents formats allant du web au support papier. L’usage de Tex peut se faire dans un terminal texte, une application user-friendly et même via une interface web.

La gestion des versions se fera avec un numéro de publication du document.

Laisser un commentaire