Skip to content

To Do per l'attività di Verifica

davidecastello edited this page May 2, 2016 · 1 revision

Premessa

Il seguente è un elenco riassuntivo a solo scopo di ricordarsi i passi da fare nella verifica di un documento. Per approfondimento fare riferimento alle Norme di Progetto

TO-DO

  1. Utilizzare strumento diario modifiche per vedere gli errori tipici nelle modifiche documento e controllare le sezioni da verificare e le issue relative alle parti da verificare con 'ToVerify'
  2. Inserire nel glossario parole fonti di ambiguità
  3. Aprire issue github
    • sezione problema
    • descrizione errori elenco checkbox
    • motivazione
    • label: REQUEST -> RdP fa QUESTION -> Assegnazione ToDo -> Lavoro WORKING -> Fatto ToVerify -> Verificatore ???
  4. Resoconto manuale (tabella)
    • periodi troppo lunghi o complessi

    • parole inappropriate

    • incongruenze

    • errori concettuali

    • termini candidati al glossario

    • termini aggiunti al glossario

  5. Resoconto automatico (tabella)
    • errori ortografici

    • utilizzo errato LaTeX

    • indici Gulpease
  6. Diario delle modifiche
    • eseguire lo script manualDiaryGenerator.sh da terminale (o git bash per W10 dopo averlo modificato opportunamente, vedi wiki page apposita);
    • seguire il procedimento guidato esplicitando iniziale nome e cognome, sigla documento di interesse, messaggio (Verifica sezione ...) e ruolo 'ver';
    • lo script registrerà la verifica effettuata e compilerà il documento in automatico;
    • NB lo script incrementa di versione (va bene).