cat python/presentare-il-progetto.md

Lezione 48 25 min

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

  1. Scrivi un README breve.
  2. Inserisci comando di avvio.
  3. Aggiungi tre screenshot testuali o esempi di uso.
  4. 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.