Raccolte di risorse

Per ciascun insegnamento, raccogliamo in modo organizzato appunti, testi e soluzioni di esercizi e prove di esame, libri, dispense, lucidi e molto altro. Dal loro caricamento diventano visionabili sulle istanze:

Controllo qualità

Quando contribuisci con le tue risorse o stai per accettare il lavoro di un’altra persona, assicurati:

  • di non caricare/accettare contenuti duplicati, incomprensibili, inutili, offensivi o illegali;
  • che tutti i controlli automatici passino;
  • di usare, dove possibile, “sorgenti” .tex/.md/.typ/.doc(x)/.odt(x) e simili anziché le loro controparti “compilate” PDF/HTML (e comunque mai immagini non incorporate in altri documenti);
  • di caricare, se possibile, la risorsa stessa anziché un collegamento a una sua versione esterna: in questo modo rendi possibile ad altre persone ampliarla e correggerla in futuro.
Aggiornare le raccolte in massa
Introduzione La repository csunibo/update contiene un semplice script Bash per applicare le stessa patch (in formato .diff) a tutte le repository degli insegnamenti in un colpo solo. Prima di cominciare Per ogni repository, le password di eventuali chiavi ssh e gpg vengono chieste da git circa 4 volte.
ott 6, 2023
Contribuire a un insegnamento
Se sei alle prime armi, usare l’interfaccia web di GitHub è un modo facile di contribuire alle risorse di un insegnamento: quando visioni le risorse che vuoi modificare, a destra del percorso in cima alla pagina clicca sull’icona GitHub ; in alto a destra, clicca su “Fork” e, sulla pagina risultante, “Create fork”; visualizzerai github.
lug 29, 2023
Aggiungere un nuovo insegnamento
Aggiungere un nuovo insegnamento è facile, se ti trovi già all’interno dell’organizzazione CSUnibo su GitHub: su template-it/template-en, usa “Use this template”/“Create a new repository”; come nuovo nome, usa la-convenzione-kebab-case, ing- come eventuale prefisso per Ingegneria informatica, isi- come eventuale prefisso per Ingegneria e scienze informatiche (non servono prefissi per distinguere triennali da magistrali); come descrizione, usa una frase simile a “Una raccolta di risorse per l’insegnamento di Linguaggi di programmazione (04138) del Corso di Laurea in Informatica”; scegli “Public” e vai su “Create repository from template”; abilita GitHub Pages da “Settings” / “Pages” impostando “Source” come “GitHub Actions”; concedi i diritti “Mantain” ai gruppi interessati.
giu 6, 2023
Controlli automatici
Quando ci sono nuove modifiche su una PR o sulla branch main, vengono eseguiti alcuni controlli automatici. È bene che tutti i controlli passino prima che la PR venga accettata. Le moderatrici e i moderatori ti aiuteranno lungo tutto il percorso.
apr 5, 2023