diff --git a/docs/01-configurazione-utente.md b/docs/01-configurazione-utente.md new file mode 100644 index 0000000..8a165eb --- /dev/null +++ b/docs/01-configurazione-utente.md @@ -0,0 +1,76 @@ + + +# Configurazione utente Git (Meridiana) + +Prima di usare Git, **imposta nome ed email**. Serviranno a firmare i commit. + +## Configurazione globale (vale per tutti i repo del tuo utente) + +Esegui una volta: + +```bash +git config --global user.name "Nome Cognome" +git config --global user.email "nome.cognome@dominiolavoro.tld" + +``` + +E' possibile verificare con + +```bash +git config --global --list + +``` + +Output di esempio: + +```bash +user.name=Nome Cognome +user.email=nome.cognome@meridiana.it +``` + +## Configurazione specifica per un singolo repository + +Se per un progetto vuoi usare un’altra email (es. personale): + +```bash +cd path/del/repo +git config user.name "Nome Cognome" +git config user.email "nome.cognome@esempio.com" + +``` + +Questa configurazione **sovrascrive** quella globale solo in quel repository. + +## Altre impostazioni consigliate + +### Editor di default +Per messaggi di commit multi-riga, Git può aprire un editor. Esempio con VS Code: + +```bash +git config --global core.editor "code --wait" +``` + +### Nome branch principale + +Lo standard git prevede che il nome della branch principale sia **master**. +Alcuni strumenti, oppure git stesso, potrebbero utilizzare **main** come nome per la branch primaria. + +Per modificare questo comportamento: + +```bash +git config --global init.defaultBranch master +``` + +### Comandi utili per controllare configurazione completa + +A livello globale: + +```bash +git config --global --list +``` + +A livello di singolo repo: + +```bash +git config --list +```