Scrivere le funzionalità in parole semplici

Descrivere cosa deve fare l’app prima di scrivere codice.

In parole semplici

Prima del codice scrivi frasi semplici. Se non riesci a spiegare una funzione in una frase, probabilmente è troppo confusa.

Questa lezione fa parte del modulo Progetto finale guidato. L’obiettivo del modulo è: Costruire una mini app semplice, pubblicarla e saper spiegare le scelte principali.

Parole nuove

funzionalità: azione utile che l’app offre.

Cosa impari

Capire il concetto senza partire da definizioni astratte.
Vedere un esempio piccolo che puoi copiare e modificare.
Collegare l’argomento al risultato del modulo: una mini app JavaScript pubblicata online con README essenziale.

Esempio da copiare

const funzionalita = [
  "Aggiungere un libro con titolo e autore",
  "Segnare un libro come letto",
  "Mostrare solo i libri da leggere"
];

console.log(funzionalita);

Non devi memorizzare tutto subito. Prima copia l’esempio, fallo funzionare e cambia una cosa alla volta.

Esercizi

Base · facile

Scrivi le tre funzioni principali della tua app come frasi semplici, una per riga.

Soluzione

const funzionalita = [
  "Aggiungere un libro con titolo e autore",
  "Segnare un libro come letto",
  "Mostrare solo i libri da leggere"
];

Se non riesci a spiegare una funzione in una frase, probabilmente è ancora confusa.

Intermedio · medio

Per ogni funzionalità scrivi input e risultato atteso, elimina parole vaghe come «gestire» e trasforma ogni frase in un compito concreto. Ordina i compiti dal più semplice al più difficile.

Sfida · difficile

Trasforma le frasi in mini-specifiche con casi limite (es. «aggiungere» → cosa succede se il titolo è vuoto?). Spiega perché descrivere il comportamento prima del codice riduce le ambiguità e rende più facile capire quando una funzione è «finita».

Controllo finale

Hai finito quando ogni funzionalità è chiara anche senza vedere il codice.