Manuale utente¶
Questo manuale ti supporta dalla tua prima connessione a un'istanza gitrust fino alla completa autonomia: push del codice, collaborazione tramite richieste pull, gestione dei problemi e automazione dei flussi di lavoro con CI integrato. Non è necessario amministrare o comprendere l'architettura interna: questo manuale presuppone solo che tu sappia come utilizzare Git dalla riga di comando.
Percorso di apprendimento¶
Il manuale è strutturato come un corso progressivo di 4 tutorial. Ogni tutorial ti lascia in uno stato stabile e verificato prima di passare a quello successivo. L'aiuto fornito va indietro di un passo in ogni passaggio (dal copia e incolla completo alla composizione indipendente).
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.
Tutorial: impara facendo¶
I tutorial sono guidati passo dopo passo con l'output letterale previsto. Seguiteli in ordine: ognuno presuppone che il precedente sia stato completato.
- 01 — Primi passi: 2FA, chiave SSH, primo deposito — ~20 min
- 02 — Clona e invia codice — ~25 min
- 03 — Collaborare: team, problemi, richieste pull — ~25 min
- 04 — Automatizza con CI — ~20 min
Come fare: ricette per attività comuni¶
Le istruzioni rispondono a "come fare X" senza alcuna spiegazione sostanziale. Puoi visualizzarli in qualsiasi ordine a seconda delle tue necessità immediate.
Queste guide presuppongono che tu abbia seguito il percorso del tutorial. Non ripetono i passaggi fondamentali.
- Gestisci le tue chiavi SSH
- Configura 2FA
- Crea un token di accesso personale
- Gestisci team e autorizzazioni
- Apri una richiesta pull
- Unisci: avanzamento veloce, schiaccia, unisci commit
- Utilizza etichette gerarchiche
- Importa un repository esterno
- Consulta la SBOM del tuo progetto
Riferimento: informazioni tecniche esatte¶
Il riferimento è destinato alla consultazione occasionale, non alla lettura lineare. Documenta formati, modelli e comportamenti esatti.
- Modello di autorizzazioni (4 ruoli)
- API REST v1: autenticazione, impaginazione, codici di errore
- Schema YAML
.gitrust-ci.yml(modalità facile) - Sintassi Markdown supportata
- Notifiche: SSE, email, preferenze
Spiegazione: capisci il perché¶
Les explanations t'aident à construire des modèles mentaux durables. Lis-les quand tu veux comprendre pourquoi gitrust fonctionne ainsi, pas seulement comment.