Tutoriels — Apprendre gitrust pas à pas¶

Les tutoriels sont des parcours d'apprentissage guidés. Leur rôle est de te faire acquérir des compétences en te faisant réaliser quelque chose de concret — pas de t'informer sur des fonctionnalités. Chaque tutoriel te laisse dans un état précis, avec quelque chose qui fonctionne réellement.

Mode Diátaxis : Tutorial. Si tu cherches à accomplir une tâche précise que tu sais déjà faire, consulte les guides pratiques. Si tu veux comprendre pourquoi gitrust fonctionne ainsi, consulte les explications.

Parcours utilisateur (~90 min)¶

graph LR
    A[Compte créé] --> B["01 — Premiers pas
~20 min"]
    B --> C["02 — Cloner et pousser
~25 min"]
    C --> D["03 — Collaborer
~25 min"]
    D --> E["04 — Automatiser CI
~20 min"]
    E --> F[Utilisateur autonome]

    style A fill:#e8f4e8
    style F fill:#e8f4e8

État initial : tu as un compte gitrust actif et Git installé sur ta machine. État final : tu pousses du code, collabores en équipe via issues et PRs, et bénéficies d'une CI automatique.

Le niveau d'aide diminue progressivement d'un tutoriel à l'autre — c'est volontaire :

Les quatre tutoriels¶

01 — Premiers pas : active la 2FA, ajoute ta clé SSH et crée ton premier dépôt¶

Active l'authentification à deux facteurs, enregistre ta première clé SSH et crée un dépôt vide. Point d'entrée obligatoire du parcours.

Bloom : O1 Activer (2FA) · O2 Enregistrer (clé SSH) · O3 Créer (dépôt)

02 — Cloner et pousser du code¶

Génère une clé SSH ed25519, clone ton dépôt en local et pousse ton premier commit. Tu vérifies ensuite le résultat dans l'interface web.

Bloom : O1 Générer (clé SSH) · O2 Cloner (dépôt via SSH) · O3 Pousser (commit)

Avant de commencer : le tutoriel 01 doit être complété — tu dois avoir un dépôt créé et un compte actif.

03 — Collaborer : équipes, issues et pull requests¶

Crée une équipe, invite un coéquipier, ouvre une issue, travaille sur une branche et soumets ta première pull request. Tu la fusionnes et vérifies que l'issue se ferme automatiquement.

Bloom : O1 Créer (équipe) · O2 Ouvrir (issue) · O3 Ouvrir et fusionner (PR)

Avant de commencer : le tutoriel 02 doit être complété — tu dois avoir un dépôt cloné en local.

04 — Automatiser les tests avec la CI intégrée¶

Écris un fichier .gitrust-ci.yml minimal, pousse-le et observe le pipeline s'exécuter en temps réel. Tu lis le statut et les logs sur /{owner}/{repo}/ci.

Bloom : O1 Écrire (config CI) · O2 Déclencher (pipeline) · O3 Lire (résultats)

Avant de commencer : le tutoriel 03 doit être complété — tu dois avoir collaboré sur au moins une PR.

Checkpoint de parcours¶

Tu es prêt pour le tutoriel 03 si : tu peux exécuter git push origin main depuis ton dépôt local sans erreur d'authentification. Sinon, relis le tutoriel 02.

Tu es prêt pour le tutoriel 04 si : tu peux ouvrir une PR, la faire reviewer et la fusionner. Sinon, relis le tutoriel 03.

Après les tutoriels¶

Une fois les quatre tutoriels complétés, tu n'as plus besoin d'un guide pas-à-pas. Consulte :

• Les guides pratiques pour des recettes ciblées (gérer les clés SSH, configurer la 2FA, importer un dépôt…)
• La référence pour les tableaux de permissions, le schéma CI, l'API REST
• Les explications pour comprendre le modèle de collaboration, la sécurité et le cycle de vie d'une PR