Skip to content
Elliot Vaucher edited this page Sep 8, 2022 · 5 revisions

Bienvenue

En guise d'introduction générale à l'utilisation de GitHub, il convient de rappeler quelques éléments essentiels.

GitHub et le logiciel open-source

GitHub est une entreprise offrant des services de stockage, de gestion et de versioning de fichiers adressés principalement aux développeurs. GitHub utilise le logiciel de gestion de versions décentralisé Git, publié en 2005 par Linus Torvalds.

La particularité de GitHub, dont il existe des concurrents directs tels que GitLab, Bitbucket, SourceForge, est, premièrement, l'interface qu'il propose à l'utilisateur. Les fonctionnalités y sont présentées de façon claire et efficace. L'écosystème est solide et il existe un grand nombre d'applications qui viennent se greffer dessus sans poser de problème.

Mais la différence est surtout la communauté qui est active sur l'une ou l'autre de ces solutions. Or, la communauté GitHub est très active. Puisque le monde de l'informatique est aussi le monde des standards et de la puissance que ces derniers peuvent apporter, il nous a semblé opportun de construire notre projet sur GitHub. En effet, c'est ici que les logiciels des dix dernières années se développent.

Plus précisément, c'est ici que les logiciels open-source se construisent. Et force est de constater que l'idéologie open-source a le vent en poupe. Un nombre grandissant de projets optent pour ce modèle de développement, considérant que l'adoption d'un produit passe avant tout par la transparence des scripts qui lui permettent de fonctionner. L'idéologie GitHub est celle du "don't trust, verify", considérant qu'il est important de pouvoir tester soi-même la robustesse d'un programme auquel on nous demanderait de faire confiance. Bien sûr, cela s'applique essentiellement à des projets qui en sont encore aux phases de développement, et la majorité du temps la version du produit qui est commercialisé, elle, n'est plus accessible en open-source.

Mais pour un projet tel que le nôtre, il nous a semblé évident que les fichiers sources devaient être accessibles et modifiables par la communauté d'enseignant.es qui joindraient leurs forces aux nôtres.

Tout est réversible

Une des particularités du fonctionnement d'un git, dont GitHub n'est qu'une instance, est d'enregistrer l'historique entier des modifications effectuées sur les fichiers présents dans un dossier précis.

Pour des raisons qu'il ne convient pas encore d'évoquer ici, il est presque impossible de "perdre" un fichier, une modification, ou d'avoir effectué une fausse manipulation dans un git. Tout est réversible.

Il est important d'insister là-dessus. De par la nature collaborative du projet ci-contre, de multiples intervenants manipulent, modifient, annotent et commentent un objet commun via ce dépôt GitHub. Or, grâce à cette possibilité offerte par les gits de retrouver les versions précédentes des fichiers, on ne peut pas "casser" quelque chose en intervenant dessus.

Attention aux tailles des fichiers

Un corollaire de ce qui précède est que les fichiers laissent des traces. Veillez à privilégier des fichiers de poids minimes, éviter les fichiers vidéos, les fichiers audios trop volumineux, et ainsi de suite.

N'ayez pas peur de participer

Ce projet vit grâce à la participation de la communauté qui l'entoure. Nous vivons une époque intéressante où les technologies de l'information et de la communication permettent de collaborer sur des tâches de façon efficace, démocratique, distribuée. Il serait dommage de ne pas exploiter le potentiel de ces outils simplement par crainte de faire faux.

Toute contribution est bonne à prendre. Tout commentaire nous intéresse. Toute suggestion permet d'améliorer la qualité du projet. N'hésitez pas.

Bonne lecture

Dans les autres documents de ce Wiki vous trouverez tout ce dont vous avez besoin pour comprendre les interactions élémentaires qui s'offrent à vous via l'interface GitHub.

Contactez-nous pour toute question urgente directement à l'adresse : modulo-team@epfl.ch

Si vous avez une suggestion ou un commentaire moins pressant, utilisez la rubrique "Q&A" des Discussions.

Clone this wiki locally