Manuel utilisateur¶
Ce manuel t'accompagne depuis ta première connexion à une instance gitrust jusqu'à l'autonomie complète : pousser du code, collaborer via les pull requests, gérer les issues et automatiser tes workflows avec la CI intégrée. Tu n'as pas besoin d'administrer ni de comprendre l'architecture interne — ce manuel suppose seulement que tu sais utiliser Git en ligne de commande.
Parcours d'apprentissage¶
Le manuel est structuré comme un parcours progressif de 4 tutoriels. Chaque tutoriel te laisse dans un état stable, vérifié, avant de passer au suivant. L'aide fournie recule d'un cran à chaque étape (du copier-coller intégral vers la composition autonome).
graph LR
A[Compte créé] --> B[01-premier-pas
20 min]
B --> C[02-cloner-pousser
25 min]
C --> D[03-collaborer
25 min]
D --> E[04-automatiser-ci
20 min]
E --> F[Utilisateur autonome]
Checkpoint de parcours : avant de passer au tutoriel 02, tu dois pouvoir te connecter à gitrust, voir ton dépôt dans l'interface et l'accès SSH configuré. Si ce n'est pas le cas, relis le tutoriel 01.
Checkpoint de parcours : avant le tutoriel 03, tu dois avoir poussé au moins un commit sur ta branche via SSH. Si ce n'est pas le cas, relis le tutoriel 02.
Checkpoint de parcours : avant le tutoriel 04, tu dois avoir ouvert et mergé une pull request. Si ce n'est pas le cas, relis le tutoriel 03.
Tutoriels — apprendre en faisant¶
Les tutoriels sont guidés pas-à-pas avec des sorties verbatim attendues. Suis-les dans l'ordre — chacun suppose le précédent complété.
- 01 — Premiers pas : 2FA, clé SSH, premier dépôt — ~20 min
- 02 — Cloner et pousser du code — ~25 min
- 03 — Collaborer : équipes, issues, pull requests — ~25 min
- 04 — Automatiser avec la CI — ~20 min
How-to — recettes pour les tâches courantes¶
Les how-to répondent à « comment faire X » sans explication de fond. Tu peux les consulter dans n'importe quel ordre selon ton besoin immédiat.
Ces guides supposent que tu as suivi le parcours tutoriels. Ils ne répètent pas les étapes de base.
- Gérer ses clés SSH
- Configurer la 2FA
- Créer un Personal Access Token
- Gérer les équipes et permissions
- Ouvrir une pull request
- Fusionner : fast-forward, squash, merge commit
- Utiliser les labels hiérarchiques
- Importer un dépôt externe
- Consulter le SBOM de ton projet
Référence — informations techniques exactes¶
La référence est destinée à la consultation ponctuelle, pas à la lecture linéaire. Elle documente les formats, schémas et comportements exacts.
- Modèle de permissions (4 rôles)
- API REST v1 — authentification, pagination, codes d'erreur
- Schéma YAML
.gitrust-ci.yml(Easy Mode) - Syntaxe Markdown supportée
- Notifications : SSE, e-mail, préférences
Explication — comprendre le pourquoi¶
Les explanations t'aident à construire des modèles mentaux durables. Lis-les quand tu veux comprendre pourquoi gitrust fonctionne ainsi, pas seulement comment.