Modalità di consegna

Prerequisiti e repository di consegna

Le indicazioni di questo capitolo valgono per la prima volta, all’inizio del corso.

Gli sketch si scrivono attraverso Visual Studio Code, con l’assistenza dell’agente di programmazione OpenCode. L’installazione dei programmi è descritta nella guida Visual Studio Code e OpenCode, con le indicazioni per Windows e per macOS.

Serve anche un profilo su GitHub, il servizio che ospita i file in rete e ne permette la pubblicazione.

Esercitazioni e progetti vanno salvati in un repository, una cartella di cui il programma Git tiene la storia dei file. Su GitHub il repository ha una copia online, che si sincronizza con quella sul proprio computer e, con GitHub Pages, può diventare un sito web.

Le esercitazioni si raccolgono in un repository personale, che si ricava dal modello del corso:

github.com/belluscio-abafr/aa2627-tad-es-modello

La copia va chiamata “aa2627-tad-es”, uguale per tutti. Il file “README.md” del modello spiega come prepararla, ed è lo stesso che poi si ritrova nella propria copia, sia su GitHub sia dentro Visual Studio Code. Dal nome del repository discende l’indirizzo di ogni lavoro pubblicato:

https://NOMEUTENTE.github.io/aa2627-tad-es/es1/

Il progetto non va in quel repository: ognuno ne crea uno suo, così l’indirizzo del lavoro finito resta utilizzabile anche fuori dal corso. I passaggi sono gli stessi già fatti per le esercitazioni, questa volta senza il modello.

Creazione e sviluppo degli sketch

Le esercitazioni e il progetto vanno realizzati in forma di sketch, termine che indica l’insieme dei file che verranno poi interpretati ed eseguiti dal browser. Ogni esercitazione ha una cartella propria nel repository, chiamata con la sua sigla: “es1”, “es2” e così via.

• creare la cartella con il comando /crea esN di OpenCode, sostituendo “esN” con la sigla dell’esercitazione;
• scrivere il codice nel file “sketch.js” della cartella, con l’aiuto di OpenCode e controllando il risultato nel browser con Live Server;
• verificare il lavoro rispetto alle specifiche usando il comando /verifica esN, che indica i vincoli non ancora soddisfatti: conviene usarlo mentre si lavora, non solo alla fine;
• creare l’anteprima quando il lavoro è pronto, cioè un’immagine chiamata “preview.png”, tutto in minuscolo, nella cartella dell’esercitazione, che si ottiene cliccando con il tasto destro del mouse sul canvas e selezionando “Salva immagine con nome…”: serve alla pagina dei propri lavori e a quella dello stato delle attività, quindi negli sketch animati conviene salvarla in un momento significativo.

Tutti i passaggi sono descritti per esteso nel file “README.md” del repository di consegna.

Segnalazione per la revisione

Ogni esercitazione conclusa va segnalata con un modulo online che non richiede nessun account e raccoglie l’attività, il cognome e il nome, l’indirizzo del lavoro pubblicato ed eventuali note.

Modulo per la consegna

Con OpenCode il link viene visualizzato anche con il comando /consegna, che controlla la cartella, pubblica il lavoro e mostra l’indirizzo esatto da segnalare.

La segnalazione va fatta dopo aver pubblicato il lavoro: se la pubblicazione non è avvenuta, all’indirizzo segnalato non si vede nulla, o si vede una versione superata.

Le osservazioni del docente arrivano nella chat privata di Teams. Gli esiti delle revisioni si possono verificare nella pagina dello stato delle attività.

Per evitare di dilungarsi troppo con le esercitazioni e ridurre eccessivamente il tempo da dedicare al progetto, sarà possibile fare una sola revisione. La mancata risoluzione dei problemi influirà, anche se non in modo consistente, sulla valutazione finale.
Per il progetto non sono invece previsti vincoli al numero di revisioni.

Archiviazione dei file delle esercitazioni

L’archiviazione dei file va fatta dopo l’esito della revisione: prima la segnalazione con il modulo, poi le eventuali correzioni, e infine i file nella loro versione definitiva. Salvare i file su Teams non vale come consegna: una consegna è tale solo se è stata segnalata con il modulo.

I file sono quelli della cartella dell’esercitazione, già presenti nella cartella di lavoro sul proprio computer. Vanno salvati nella cartella “Esercitazioni” del canale Teams del corso (sezione “Condiviso”), all’interno di una sottocartella il cui nome deve seguire lo schema “Cognome_Nome”, con gli spazi sostituiti dal carattere “_”. Per ogni esercitazione va creata un’ulteriore sottocartella esN:

• Esercitazioni
  • …
    • *
  • Cognome_Nome
    • es0
      • index.html
      • preview.png
      • sketch.js
      • style.css
      • …
    • es1
      • *
    • …
      • *
  • …
    • *

Archiviazione dei file del progetto

Valgono le stesse condizioni: i file si archiviano dopo l’esito della revisione. Vanno salvati nella cartella “Progetti” del canale Teams del corso (sezione “Condiviso”), all’interno di una sottocartella il cui nome dovrà seguire lo schema “Cognome_Nome” o, se si tratta di un lavoro in coppia, “Cognome1-Cognome2”:

• Progetti
  • …
    • *
  • Cognome_Nome   o Cognome1-Cognome2
    • index.html
    • preview.png
    • sketch.js
    • style.css
    • …
  • …
    • *

Scadenze consegne

Tutte le esercitazioni è ovviamente meglio concluderle prima di iniziare il progetto per poterlo affrontare con maggiore sicurezza. In caso contrario la scadenza ultima per la consegna, cioè per la segnalazione con il modulo, è 7 giorni prima della data d’esame della sessione scelta.

Per il progetto la consegna va fatta entro 3 giorni prima della data d’esame della sessione scelta. Questo per dare al docente la possibilità di esaminare con maggiore attenzione i lavori e dare già una valutazione di massima comparata a quelle degli altri progetti.

Per ridurre al minimo gli upload, l’archiviazione dei file su Teams, sia delle esercitazioni sia del progetto, si può fare anche il giorno precedente l’esame.