# Git Passo-Passo per Principianti : docmd
docmd is a Node.js command-line tool for generating beautiful, lightweight static documentation sites from Markdown files.

# Git Passo-Passo per Principianti

# 🐣 Git Passo-Passo per Principianti

> 🎨 Versione guidata per chi parte da zero
> 💡 L’obiettivo: lavorare sempre su branch separati e non rompere il repository principale

## 1️⃣ Clona il repository (se non l’hai già)

Prima di iniziare a modificare, devi avere il repository sul tuo computer.

    git clone [URL-DEL-REPOSITORY]
    cd [NOME-REPO]

🔹 [URL-DEL-REPOSITORY] → indirizzo del repository remoto
🔹 [NOME-REPO] → la cartella del progetto

2️⃣ Controlla lo stato del repository

    git status

Ti mostra quali file sono stati modificati e se ci sono modifiche non salvate.

3️⃣ Crea un nuovo branch
Sempre creare un branch nuovo per ogni modifica!
Così il branch principale (main o master) rimane sicuro.

    git checkout -b feature/nome-modifica

🔹 Usa un nome chiaro, es: feature/login

4️⃣ Modifica i file
Fai le modifiche necessarie nei file del progetto.

5️⃣ Aggiungi i file allo staging

    git add <file>

🔹 [file] → il file specifico che vuoi salvare
🔹 Usa . per aggiungere tutti i file modificati

6️⃣ Salva le modifiche con un commit

    git commit -m "Messaggio chiaro sulla modifica"

🔹 Usa un messaggio chiaro: es. Aggiunto modulo login o Corretto bug funzione X

7️⃣ Aggiorna il branch remoto
Prima di inviare le modifiche, assicurati di avere l’ultima versione del repository remoto:

    git pull origin main

Poi invia il tuo branch:

    git push origin feature/nome-modifica

8️⃣ Apri una Pull Request (PR)
🔹 Vai sul repository remoto (GitHub, GitLab, ecc.)
🔹 Apri una PR dal tuo branch verso main
🔹 Descrivi cosa hai fatto e richiedi revisione

9️⃣ Dopo che la PR è approvata
Torna sul branch principale aggiornato:

    git checkout main
    git pull origin main

Puoi cancellare il branch locale se non serve più:

    git branch -d feature/nome-modifica

💡 Suggerimenti rapidi
✅ Sempre lavorare su un branch nuovo
✅ Commit frequenti e chiari
✅ Pull prima di push
✅ Controlla sempre git status

🔗 Risorse utili: Git Documentation