Comprendre ce que Git enregistre

Quand vous modifiez un site, vous devez pouvoir retrouver ce qui a changé et revenir à un état antérieur si nécessaire. Sans historique, une correction peut effacer une version utile ou rendre difficile l’identification d’une erreur. Git répond à ce problème en vous permettant de conserver des états successifs de votre projet.

Dans cette leçon, vous allez distinguer trois éléments : les fichiers sur lesquels vous travaillez, les versions que vous décidez de conserver et l’emplacement où Git garde l’historique du projet. Cette distinction vous aidera à comprendre les opérations pratiques des prochaines leçons, sans encore créer de dépôt ni enregistrer de version.

Les fichiers de travail : le contenu du site

Votre projet fil rouge est un petit site statique composé de index.html, style.css et README.md. Ces fichiers contiennent respectivement la page, sa présentation et la documentation des étapes du projet. Tant que vous travaillez, vous pouvez les ouvrir, les modifier et enregistrer vos changements dans votre éditeur : ce contenu courant constitue votre état de travail.

Par exemple, vous pouvez ajouter une phrase à l’introduction de la page, ajuster la feuille de style ou noter dans le README que le site suit ses versions. Ces modifications existent dans les fichiers de votre projet, mais leur présence ne signifie pas encore que Git en a conservé un état. Git ne transforme pas chaque frappe en une version de l’historique.

Le suivi des modifications

Le suivi des modifications désigne la capacité de Git à conserver l’évolution des fichiers d’un projet. Il vous permet de relier des états successifs du site et de comprendre comment son contenu a changé. Vous pouvez ainsi associer une évolution à une intention concrète, comme présenter le projet, corriger un texte ou documenter une étape.

Suivre un projet ne signifie pas que chaque fichier de votre ordinateur est concerné. Le suivi porte sur le contenu du projet que vous choisissez de gérer. Dans le cas du site, l’objectif est de conserver les fichiers utiles à sa réalisation et sa documentation, et non des réglages personnels de votre poste ou des éléments sans rapport avec le site.

Une version enregistrée et un dépôt local

Une version enregistrée est un état du projet que vous décidez de conserver dans son historique. Elle correspond à une étape identifiable du travail : par exemple, la création de la page d’accueil ou l’ajout des sections sur l’état et l’historique du dépôt. Enregistrer une version n’est donc pas la même chose que sauvegarder le fichier dans votre éditeur : la sauvegarde met à jour le fichier courant, tandis que la version enregistrée conserve un état dans l’historique Git.

Le dépôt local est l’emplacement associé au projet où Git conserve ses données de suivi et les versions enregistrées. Il se trouve sur votre ordinateur et permet de travailler sur l’historique sans avoir besoin d’une connexion à une forge. Le mot « local » le distingue d’un dépôt distant, qui se trouve sur un service en ligne et pourra être relié au projet plus tard dans le cours.

Vous pouvez vous représenter le fonctionnement comme une séparation entre l’état actuel des fichiers et les états conservés par Git. Vous modifiez le site dans les fichiers de travail, puis vous choisissez les étapes qui méritent d’être gardées dans l’historique. Le dépôt local rassemble ces versions et vous permet de les retrouver. Les commandes permettant de mettre ce cycle en place seront étudiées dans les leçons suivantes.

Appliquer ces distinctions au site

Imaginez que vous ajoutiez dans README.md une courte description du site, puis que vous mettiez à jour index.html pour présenter sa publication à venir. Vous avez alors changé deux fichiers de travail. Si vous décidez de conserver ces modifications comme une étape du projet, vous créez une version enregistrée dans le dépôt local ; l’historique pourra alors montrer que la documentation et la page ont évolué.

Avant d’enregistrer une étape, réfléchissez à ce qu’elle représente. Une version utile décrit un changement cohérent, plutôt qu’un mélange de retouches sans lien. Pour ce projet, vous pourriez distinguer la création de la page de l’ajout de sa documentation ; les messages de commit en français et l’organisation précise des étapes seront abordés plus tard.

À retenir

• Les fichiers de travail contiennent l’état courant de votre site.
• Le suivi des modifications conserve l’évolution des fichiers choisis pour le projet.
• Une version enregistrée est un état du projet conservé dans son historique.
• Le dépôt local stocke cet historique sur votre ordinateur.
• Sauvegarder un fichier dans votre éditeur ne suffit pas à créer une version Git.

Dans la prochaine leçon, vous préparerez votre identité Git en veillant à ne pas versionner de configuration personnelle.