Benvenutə su unipr-org, l'organizzazione GitHub dedicata a riunire lɜ studentɜ di Informatica dell'Università di Parma per creare una ricca e condivisa raccolta di appunti. Siamo entusiasti di darti il benvenuto nel nostro progetto collaborativo, dove chiunque può contribuire e beneficiare dalla condivisione di conoscenze.
unipr-org nasce con l'obiettivo di promuovere la collaborazione e la condivisione di risorse accademiche tra lɜ studentɜ dell'Università di Parma. La nostra missione è creare una piattaforma aperta e accessibile dove si può collaborare per sviluppare una vasta raccolta di appunti, materiale didattico e risorse utili per tutti i corsi offerti dall'università.
Siamo entusiasti di accogliere nuovi membri nell'organizzazione unipr-org. Se sei unə studentə dell'Università di Parma e desideri contribuire o trarre vantaggio dalla raccolta di appunti, ecco come puoi partecipare:
-
Unisciti all'organizzazione: una volta dentro la repository del corso in questione, fai clic sul pulsante "Fork" in alto a destra per clonarla sulla tua pagina GitHub. In seguito, potrai contribuire e sottoporre richieste di pull.
-
Contribuisci con i tuoi appunti: carica i tuoi appunti, materiale didattico o risorse utili nei rispettivi repository del corso. Assicurati di seguire le linee guida per il contributo indicate nei singoli repository.
-
Apri issues: se hai suggerimenti, domande o problemi, apri una "Issue" nel repository corrispondente. Il dialogo è fondamentale per migliorare la qualità e l'efficacia della raccolta.
-
Diventa un collaboratore regolare: se sei appassionato della condivisione di conoscenze e vuoi svolgere un ruolo più attivo, contattaci per diventare un collaboratore regolare. Avrai maggiori responsabilità e potrai contribuire attivamente alla gestione dell'organizzazione.
-
Condividi la raccolta con i tuoi amici: più siamo e meglio è!
Per garantire la coerenza e la qualità della raccolta, si prega di seguire le linee guida di contributo presenti nei repository specifici dei corsi. In generale, suggeriamo:
- utilizzo di formati standard per i documenti, come Markdown o PDF.
- inclusione di dettagli utili, come annotazioni, spiegazioni chiare e link a risorse esterne pertinenti.
- rispetto del lavoro degli altri e la collaborazione aperta.
Raccomandiamo inoltre di attribuire unə autorə al materiale caricato, escludendo riferimenti personali esterni.
Ecco un semplice elenco di linee guida da seguire per partecipare alla stesura degli appunti e per mantenere il codice il più ordinato e leggibile possibile.
- Per visualizzare bene gli appunti utilizzeremo Obsidian: software che permette di prendere appunti che opera su file Markdown
.md. La preview che si vede su Github può risultare incompleta o non leggibile. - Plugin utilizzati su Obsidian:
- Effettuare un
git forkdella repository in questione, nella quale poi si andranno a modificare / aggiungere appunti. - Prima di ogni modifica, assicurarsi di essere aggiornati con l'ultima versione della repository tramite un
git fetche successivamente ungit merge. - Non utilizzare caratteri in stampato e caratteri speciali nel nome dei file.
- Utilizzare il carattere
_al posto degli "spazi" nel nome dei file. - Utilizzare sempre la numerazione dei file nel nome (i numeri indicano l'ordine degli argomenti trattati a lezione).
- Nel file
.mdinserire sempre un indice dinamico (utilizzando il plugin) e un "ritorna all'indice" alla fine di ogni paragrafo / argomento.
Il primo argomento trattato a lezione è stato quello del significato di "Hello, world!".
Il nome file sarà: 01-helloworld.md.
Il titolo del commit sarà: "Aggiunti appunti lezione 01-helloworld".
Il titolo della pull request sarà: "Appunti lezione 26-02-2023".
Se hai domande, suggerimenti o desideri entrare in contatto con la community unipr-org, puoi farlo attraverso:
Grazie per essere parte di unipr-org! Insieme possiamo rendere l'apprendimento universitario più accessibile e collaborativo per tuttɜ lɜ studentɜ dell'Università di Parma.
