Dare un nome chiaro ai file e gestire le versioni non è pignoleria: è ciò che ti fa trovare subito ciò che cercate, capire al volo quale documento è l’ultimo e collaborare senza caos. In classe e nei progetti di gruppo capita spesso di avere decine di file chiamati “Relazione definitiva (nuova)”, “Relazione_ultimissima (1)”, “prova2_bis.pdf”. Risultato: si perde tempo, si consegna il file sbagliato, si confondono revisioni e correzioni del docente.

Un buon naming (come chiami il file) e un semplice versioning (come tenete traccia delle versioni) risolvono questi problemi perché:

• i file sono ordinabili in modo naturale (per data, per progetto, per autore);
• il nome racconta cosa contiene e a che punto è (v1.0, v1.1, v2.0…);
• lavorare in gruppo diventa più semplice (ognuno segue la stessa convenzione);
• la consegna è pulita: il docente vede subito cosa aprire, senza dubbi.

Non serve un software complicato: basta una regola condivisa e costante. Con una convenzione semplice, in 1 secondo capisci versione, tema e autore; in 2 clic trovi tutto ciò che ti serve.

Esempio sintetico:

• Nomi coerenti = cercare e condividere senza perdersi.
• Regola: AAAA-MM-GG_progetto-parole-chiave_vX.Y_autore.ext.
  Ordinabile per data, leggibile da tutti, facile da versionare. Evita spazi e caratteri strani; usa trattini.
• Cartelle consigliate: /classe/materia/progetto/gruppo/.

Scarica PDF A4 della guida operativa – Apri il sorgente Markdown su GitHub

Se non sai cos’è il Markdown segui il link

---
title: "QR – Nomi file & versioni come i pro"
version: "1.1"
autore: "<Classe/Studente>"
licenza: "CC BY 4.0"
ultimo_aggiornamento: "2025-10-05"
---

# Perché una convenzione aiuta
- Trovi i file subito (ordinamento per data e nome).
- Capisci a colpo d’occhio contenuto e versione.
- Meno conflitti/doppioni nei lavori di gruppo.
- Consegne pulite e professionali.

## Convenzione base (da usare)
`AAAA-MM-GG_progetto-parole-chiave_vX.Y_autore.ext`

**Spiegazione**
- `AAAA-MM-GG` = data (es. 2025-10-05)
- `progetto-parole-chiave` = tema + 1–3 parole utili (senza spazi; usa trattini)
- `vX.Y` = versione (X=major, Y=minor: v1.0, v1.1, v2.0…)
- `autore` = cognome o nome-cognome / nome del team
- `ext` = estensione (.pdf, .docx, .ino, .csv, .pptx…)

## Struttura cartelle consigliata
/classe/materia/progetto/gruppo/{dati,codice,relazione,media}

## Regole d’oro
- Usa trattini `-` o underscore `_` (no spazi, accenti, emoji).
- Minuscole coerenti; nomi descrittivi.
- Incrementa solo la parte necessaria della versione.
- Esporta un PDF finale per le consegne.

## Versioning semplice
- Inizio: v1.0 (prima consegna “completa”)
- Piccole correzioni: v1.1, v1.2 …
- Cambio sostanziale: v2.0
- Se arrivano commenti del docente: crea una nuova versione (non sovrascrivere)

## Modelli pronti (copia e incolla)
- Relazione (PDF): `AAAA-MM-GG_relazione-_vX.Y_.pdf`
- Codice Arduino: `AAAA-MM-GG__vX.Y_.ino`
- Dataset CSV: `AAAA-MM-GG_dati--_vX.Y_.csv`
- Presentazione: `AAAA-MM-GG_presentazione-_vX.Y_.pptx`
- Immagine/Figura: `AAAA-MM-GG_fig--_vX.Y_.png`

## Esempi rapidi (solo nomi, da imitare)
- 2025-10-05_relazione-arduino_stazione-ambientale_v1.0_rossi.pdf
- 2025-10-05_codice-sensore-luce_v1.3_rossi.ino
- 2025-10-05_dati-luce-umidita-aula3_v0.3_teamB.csv

## Checklist finale
- [ ] Stesso formato per tutti i file del progetto
- [ ] Versione aggiornata (vX.Y) coerente
- [ ] Niente duplicati “finale_definitivo(3).docx”
- [ ] PDF esportato per la consegna

Esempio 01 – Consegna di gruppo (Arduino)

• Cartella: /3B/info/stazione-ambientale/teamB/
• File:
  2025-11-12_relazione-stazione-ambientale_v1.2_teamB.pdf
  2025-11-12_dati-luce-umidita-aula3_v1.0_teamB.csv
  2025-11-12_codice-lettura-sensori_v1.3_teamB.ino
  2025-11-12_fig-01-schema-cablaggio_v1.0_teamB.png

Esempio 02 – Correzioni del docente > nuova versione

• Prima: 2025-11-12_relazione-stazione-ambientale_v1.2_teamB.pdf
• Dopo correzioni: 2025-11-15_relazione-stazione-ambientale_v1.3_teamB.pdf
• Changelog (facoltativo): “2025-11-15 v1.3: aggiunte unità SI; rigenerato grafico con etichette leggibili.”