Babouins
La doc du BTS SIO, écrite par ses étudiants
Procédures, commandes et aide-mémoire, rangés par thème et lisibles sans compte. Une page manque ou contient une erreur ? Tu peux l'écrire ou la corriger, depuis l'éditeur en ligne ou avec Git.
Le concept
-
Centraliser
Procédures, commandes et tutos vus en cours, réunis sur docs.babouins.fr. Un seul endroit où chercher, accessible à toute la classe : c'était déjà l'idée du projet d'origine, en 2024.
-
Collaborer
Chacun peut écrire, corriger ou compléter une page, sans demander la permission. La relecture par 2 autres membres de la classe vient ensuite, pas avant.
-
Apprendre les outils pros
Git, pull requests, revue de code, CI/CD : tout le projet peut aussi se pratiquer avec les outils utilisés en entreprise. C'est une option, pas un péage pour écrire.
Deux façons d'écrire, une seule relecture
Depuis le site
L'éditeur en ligne
Un éditeur visuel, dans le navigateur : titres, listes, blocs de code, images. Tu ranges les pages en les faisant glisser, et tu enregistres avec Ctrl + S. Un mode Markdown existe pour qui le préfère.
Ouvrir l'éditeurDepuis GitHub
Git et les pull requests
$ git clone https://github.com/<ton-pseudo>/docs.babouins.fr.git
$ git checkout -b <branche>
$ git add .
$ git commit -m "Décris ta modification en une phrase"
$ git push -u origin <branche>
Les 5 commandes Git du guide de contribution, telles qu'elles y sont écrites. Il n'y a rien d'autre à connaître pour proposer une page depuis ton ordinateur.
Voir le dépôt de la docLes deux chemins arrivent au même endroit : une proposition, qui attend les mêmes 2 validations. Le guide détaille les deux méthodes.
Comment ça marche
4 étapes, 2 validations, 2 façons d'écrire
-
Proposer
Tu écris ou tu corriges une page, depuis l'éditeur du site ou avec Git. Dans les deux cas, elle part en relecture.
-
Relire
Les autres membres de la classe lisent ta proposition, commentent et suggèrent des corrections.
-
Valider à 2
Il faut 2 validations pour publier : la règle date du projet d'origine, en 2024. Les référents du projet peuvent publier directement quand il faut aller vite.
-
Déploiement automatique
La page validée est mise en ligne toute seule, en quelques minutes. Les lecteurs qui l'avaient ouverte la voient se mettre à jour sans recharger.
Tu peux même modifier cette page
Cette vitrine n'a pas d'éditeur en ligne : elle se modifie sur GitHub, avec une pull request validée par 2 membres de la classe. La page que tu lis tient dans un seul fichier de 503 lignes : src/pages/index.astro. Une faute, une phrase pas claire, une idée ? Propose ta modification.
Jusqu'où va Babouins
Un complément, pas un cours. Le contenu est écrit par des étudiants, pour des étudiants. Il complète les cours et la documentation officielle des éditeurs, il ne les remplace pas. Une erreur peut passer malgré 2 relectures : tout reste modifiable, par tout le monde.
Une relecture, pas un verrou. Les référents du projet peuvent publier une page sans attendre les 2 validations, pour corriger vite une erreur gênante. Rien n'est caché pour autant : chaque publication reste dans l'historique, au nom de son auteur, et peut être relue après coup.
Un projet qui redémarre. Créé en 2024, à l'arrêt depuis février 2025, puis repris en 2026 par la promo BTS SIO 2026-2028. La documentation se remplit au fil des cours : certaines pages n'existent pas encore.
Rien qui vienne d'une entreprise. Aucune information issue d'une entreprise d'alternance n'a sa place ici : ni adresse IP, ni nom de domaine interne, ni identifiant, ni capture d'écran non anonymisée. La règle vaut pour le texte, les images et les messages de commit. Lire les règles de sécurité
Projet repris par la promo BTS SIO 2026-2028 (Olivier Dutoit). Projet original créé en 2024 par Dimitri Chassignol, Jordan Digat et Mathis Norel. En savoir plus