cat python/presentare-il-progetto.md
Presentare il progetto
Preparare README, spiegazione e prossimi miglioramenti.
Prima idea
Saper spiegare un progetto e parte del lavoro. Non basta dire funziona: devi raccontare cosa fa, come si avvia, quali scelte hai fatto e cosa miglioreresti.
Questa lezione fa parte del modulo Progetto finale guidato. L’obiettivo del modulo è: Costruire un progetto piccolo, completo e presentabile, senza saltare pianificazione, controlli e spiegazione.
Parole nuove
- README: file che spiega progetto, avvio e uso.
- retrospettiva: breve riflessione su cosa ha funzionato e cosa no.
Cosa impari
- Scrivere istruzioni di avvio.
- Mostrare tre funzionalita principali.
- Raccontare un problema risolto.
Esempio da copiare
# Titolo progetto
## Cosa fa
Gestisce una piccola raccolta da terminale.
## Come si avvia
python app.py
## Prossimi miglioramenti
- ordinamento
- ricerca migliore
Prima copialo senza modificarlo. Poi cambia una cosa sola e riesegui: una parola, un numero, un messaggio o un valore.
Prova guidata
- Scrivi un README breve.
- Inserisci comando di avvio.
- Aggiungi tre screenshot testuali o esempi di uso.
- Scrivi due miglioramenti futuri.
Sfida piccola
Prendi l’esempio e rendilo tuo senza aggiungere complessità inutile. Se qualcosa si rompe, torna all’ultima versione funzionante e cambia una riga per volta.
Controllo finale
Hai finito quando una persona esterna può avviare il progetto leggendo il README.