1
Fork 0
mirror of https://github.com/pds-nest/nest.git synced 2024-11-22 04:54:18 +00:00
pds-2021-g2-nest/docs/source/development/suggestions.rst

56 lines
3.1 KiB
ReStructuredText

Suggerimenti relativi al corso
==============================
* Il team concorda sull'**utilità del progetto** poiché permette di utilizzare le nozioni viste a lezione nella pratica,
facendo quindi esperienza sulle varie metodologie da adottare e le varie problematiche in cui si può incorrere.
* Il team concorda nel dire che **il progetto è eccessivamente corposo**:
* Tecnicamente a 6 CFU dovrebbero corrispondere circa 125 ore di lavoro, mentre questo progetto ne ha richieste molte di più.
* Suggeriamo quindi di **alleggerire significativamente il carico di lavoro**, e renderlo più proporzionato ai
crediti previsti.
* Il team suggerisce di lasciare agli studenti **scelta completamente libera sugli strumenti da adottare**, in quanto si
sono verificati svariati problemi con quelli previsti dal corso:
* Le istanze di Taiga, GitLab e SonarQube ospitate dall'Università si sono dimostrate inaffidabili,
portando il team a dover ospitare le proprie e quindi a perderci una fetta significativa del proprio tempo.
* CAS è supportato solo su Debian, e lo script di installazione esegue operazioni con effetti collaterali sul
Docker del sistema host.
* L'installazione di Taiga tramite Docker Compose ha richiesto 5 ore, in quanto una race condition presente nel
file ``docker-compose.yml`` impediva al software di raggiungere il database.
* L'installazione e manutenzione di GitLab ha richiesto 5 ore, e richiede competenze di amministrazione di sistema
avanzate che sono oltre il livello dello studente medio del terzo anno di Informatica.
* Taiga, per quanto funzionale, è un po' acerbo a livello di User Experience, il che ha portato a svariati grattacapi
durante il suo utilizzo da parte del team.
* Inoltre, è in parte superfluo: quasi tutte le funzionalità che fornisce sono già implementate sui sistemi di issues
di GitHub e GitLab.
* Utilizzare GitLab invece che il più popolare GitHub impedisce di sfruttare la licenza gratuita o `universitaria`_ di
numerosi strumenti di Continuous Integration e Deployment, quali `GitHub Actions`_, `Read the Docs`_ e `Render`_.
* SonarQube, per quanto semplice da installare, è molto complesso da utilizzare: il team ha necessitato di parecchie
ore per capirne il funzionamento.
* È forse anche superfluo: tutte le issues che ha segnalato erano già state segnalate in precedenza dal sistema di
linting di IntelliJ IDEA Ultimate.
* Il team concorda nel dire che sarebbe molto utile la **partecipazione diretta del prof** durante le prime fasi di
progetto, all'inizio del lavoro, per instradare il gruppo nella giusta direzione ed evitare l'effetto "salto nel buio":
* Sarebbe stato piacevole avere una spiegazione più dettagliata delle regole dello Scrumble, e soprattutto sul come
giocarlo a distanza.
* Sarebbero state utili lezioni più specifica sui tool da utilizzare, come SonarQube.
.. _universitaria: https://education.github.com/pack
.. _GitHub Actions: https://github.com/features/actions
.. _Read the Docs: https://readthedocs.org/
.. _Render: https://render.com/