Git pour gérer des documents ?

Bonjour à toutes et à tous !

Je suis en cinquième année en école d'ingénieur, et je me rends compte que je travaille de plus en plus sur des documents "texte" (cahiers des charges, dossiers de conception ou de tests…) et de moins en moins sur du code.

Ceci dit, on travaille tout de même en équipe, et un outil de versionnage peut être un outil précieux. Parce que bon, Google Drive, ça va bien cinq minutes, mais ça fonctionne particulièrement mal en terme d'historisation et de traçabilité.

Du coup, je pose l'idée ici pour avoir vos remarques, vos idées, ou même des retours d'expérience si certains d'entre vous ont déjà expérimenté cette méthode.

Est-ce que Git peut fonctionner pour versionner des documents texte, avec Markdown par exemple ?

Puisque zds le fait, je dirais que c'est totalement utilisable pour ce genre de chose.

Salut, c'est ce qui est fait ici pour les articles et tutoriels.

edit : je suis rôti

… et perso je l'ai fait plusieurs fois quand j'étais en thèse. C’était du latex mais tant que les documents sont basés sur du texte, git fonctionne aussi bien qu'avec du code.

Ah oui, tiens, c'est vrai ça

Et est-ce que le branchage peut apporter quelque chose en terme de travail d'équipe selon vous ?

Oui, clairement. Si tu travailles en parallèle sur plusieurs documents au sein un même dépôt par exemple, ça permet un historique plus propre. Voire même de travailler sur plusieurs versions d'un même document.

Je suis entrain de préparer un article sur un sujet assez similaire. Je compte parler d'un outil qui s'appelle git annex dont un des objectifs est de faire de l'archivage. L'intérêt de cet outil c'est notamment de ne pas garder sur ton PC tous les fichiers. En effet, tu peux facilement accumuler des dizaines de milliers de fichiers dont une partie d'entre eux (notamment en utilisant Git) ne servent plus. Et donc git annex te permet de juste les stocker sur un serveur et de ne pas avoir ces fichiers en local.

Dans mon ancienne boîte, la doc entière du projet était versionnée (en markdown) dans le même repo git que le code. Ça n'a jamais posé le moindre problème.

D’autant plus qu’il existe des outils pratiques comme Sphinx, MkDocs voire Pandoc pour avoir un document en sortie sans se prendre la tête. Moi-même, je m’occupe de la documentation de Otter Browser en rédigeant en reStructuredText et en utilisant Git pour le versionnement et c’est vraiment pratique.