mirror of
https://github.com/pds-nest/nest.git
synced 2024-11-25 22:44:19 +00:00
281 lines
No EOL
10 KiB
HTML
281 lines
No EOL
10 KiB
HTML
|
|
|
|
<!DOCTYPE html>
|
|
<html class="writer-html5" lang="it" >
|
|
<head>
|
|
<meta charset="utf-8" />
|
|
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
|
|
<title>Suggerimenti relativi al corso — N.E.S.T. 0.1.0 documentazione</title>
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
|
|
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
|
|
<link rel="stylesheet" href="../_static/custom.css" type="text/css" />
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!--[if lt IE 9]>
|
|
<script src="../_static/js/html5shiv.min.js"></script>
|
|
<![endif]-->
|
|
|
|
|
|
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
|
|
<script src="../_static/jquery.js"></script>
|
|
<script src="../_static/underscore.js"></script>
|
|
<script src="../_static/doctools.js"></script>
|
|
<script src="../_static/translations.js"></script>
|
|
|
|
<script type="text/javascript" src="../_static/js/theme.js"></script>
|
|
|
|
|
|
<link rel="index" title="Indice" href="../genindex.html" />
|
|
<link rel="search" title="Cerca" href="../search.html" />
|
|
<link rel="next" title="Meta-documentazione" href="../code/meta/index.html" />
|
|
<link rel="prev" title="Conclusioni" href="conclusions.html" />
|
|
</head>
|
|
|
|
<body class="wy-body-for-nav">
|
|
|
|
|
|
<div class="wy-grid-for-nav">
|
|
|
|
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
|
|
<div class="wy-side-scroll">
|
|
<div class="wy-side-nav-search" style="background: #3B7097" >
|
|
|
|
|
|
|
|
<a href="../index.html" class="icon icon-home"> N.E.S.T.
|
|
|
|
|
|
|
|
</a>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div role="search">
|
|
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
|
|
<input type="text" name="q" placeholder="Search docs" />
|
|
<input type="hidden" name="check_keywords" value="yes" />
|
|
<input type="hidden" name="area" value="default" />
|
|
</form>
|
|
</div>
|
|
|
|
|
|
</div>
|
|
|
|
|
|
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<p class="caption"><span class="caption-text">Manuale utente</span></p>
|
|
<ul>
|
|
<li class="toctree-l1"><a class="reference internal" href="../guide/about.html">Il progetto in breve</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../guide/installation.html">Installazione</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../guide/updating.html">Aggiornamento</a></li>
|
|
</ul>
|
|
<p class="caption"><span class="caption-text">Relazione sul progetto</span></p>
|
|
<ul class="current">
|
|
<li class="toctree-l1"><a class="reference internal" href="goals.html">Introduzione</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="tools.html">Strumenti utilizzati</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="process.html">Processo di sviluppo</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="artifacts.html">Artefatti</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="conclusions.html">Conclusioni</a></li>
|
|
<li class="toctree-l1 current"><a class="current reference internal" href="#">Suggerimenti relativi al corso</a></li>
|
|
</ul>
|
|
<p class="caption"><span class="caption-text">Documentazione tecnica</span></p>
|
|
<ul>
|
|
<li class="toctree-l1"><a class="reference internal" href="../code/meta/index.html">Meta-documentazione</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../code/database/index.html">Struttura del database</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../code/backend/index.html"><code class="docutils literal notranslate"><span class="pre">nest_backend</span></code> - Web API in Python</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../code/crawler/index.html"><code class="docutils literal notranslate"><span class="pre">nest_crawler</span></code> - Crawler in Python</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../code/frontend/index.html"><code class="docutils literal notranslate"><span class="pre">nest_frontend</span></code> - Interfaccia utente in React</a></li>
|
|
</ul>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
</div>
|
|
</nav>
|
|
|
|
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
|
|
|
|
|
|
<nav class="wy-nav-top" aria-label="top navigation">
|
|
|
|
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
|
|
<a href="../index.html">N.E.S.T.</a>
|
|
|
|
</nav>
|
|
|
|
|
|
<div class="wy-nav-content">
|
|
|
|
<div class="rst-content">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
|
|
<ul class="wy-breadcrumbs">
|
|
|
|
<li><a href="../index.html" class="icon icon-home"></a> »</li>
|
|
|
|
<li>Suggerimenti relativi al corso</li>
|
|
|
|
|
|
<li class="wy-breadcrumbs-aside">
|
|
|
|
|
|
<a href="../_sources/development/suggestions.rst.txt" rel="nofollow"> View page source</a>
|
|
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
|
|
<hr/>
|
|
</div>
|
|
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
<div itemprop="articleBody">
|
|
|
|
<div class="section" id="suggerimenti-relativi-al-corso">
|
|
<h1>Suggerimenti relativi al corso<a class="headerlink" href="#suggerimenti-relativi-al-corso" title="Link a questa intestazione">¶</a></h1>
|
|
<ul class="simple">
|
|
<li><p>Il team concorda sull'<strong>utilità del progetto</strong> 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.</p></li>
|
|
<li><p>Il team concorda nel dire che <strong>il progetto è eccessivamente corposo</strong>:</p>
|
|
<ul>
|
|
<li><p>Tecnicamente a 6 CFU dovrebbero corrispondere circa 125 ore di lavoro, mentre questo progetto ne ha richieste molte di più.</p></li>
|
|
<li><p>Suggeriamo quindi di <strong>alleggerire significativamente il carico di lavoro</strong>, e renderlo più proporzionato ai
|
|
crediti previsti.</p></li>
|
|
</ul>
|
|
</li>
|
|
<li><p>Il team suggerisce di lasciare agli studenti <strong>scelta completamente libera sugli strumenti da adottare</strong>, in quanto si
|
|
sono verificati svariati problemi con quelli previsti dal corso:</p>
|
|
<ul>
|
|
<li><p>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.</p>
|
|
<ul>
|
|
<li><p>CAS è supportato solo su Debian, e lo script di installazione esegue operazioni con effetti collaterali sul
|
|
Docker del sistema host.</p></li>
|
|
<li><p>L'installazione di Taiga tramite Docker Compose ha richiesto 5 ore, in quanto una race condition presente nel
|
|
file <code class="docutils literal notranslate"><span class="pre">docker-compose.yml</span></code> impediva al software di raggiungere il database.</p></li>
|
|
<li><p>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.</p></li>
|
|
</ul>
|
|
</li>
|
|
<li><p>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.</p>
|
|
<ul>
|
|
<li><p>Inoltre, è in parte superfluo: quasi tutte le funzionalità che fornisce sono già implementate sui sistemi di issues
|
|
di GitHub e GitLab.</p></li>
|
|
</ul>
|
|
</li>
|
|
<li><p>Utilizzare GitLab invece che il più popolare GitHub impedisce di sfruttare la licenza gratuita o <a class="reference external" href="https://education.github.com/pack">universitaria</a> di
|
|
numerosi strumenti di Continuous Integration e Deployment, quali <a class="reference external" href="https://github.com/features/actions">GitHub Actions</a>, <a class="reference external" href="https://readthedocs.org/">Read the Docs</a> e <a class="reference external" href="https://render.com/">Render</a>.</p></li>
|
|
<li><p>SonarQube, per quanto semplice da installare, è molto complesso da utilizzare: il team ha necessitato di parecchie
|
|
ore per capirne il funzionamento.</p>
|
|
<ul>
|
|
<li><p>È forse anche superfluo: tutte le issues che ha segnalato erano già state segnalate in precedenza dal sistema di
|
|
linting di IntelliJ IDEA Ultimate.</p></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li><p>Il team concorda nel dire che sarebbe molto utile la <strong>partecipazione diretta del prof</strong> durante le prime fasi di
|
|
progetto, all'inizio del lavoro, per instradare il gruppo nella giusta direzione ed evitare l'effetto "salto nel buio":</p>
|
|
<ul>
|
|
<li><p>Sarebbe stato piacevole avere una spiegazione più dettagliata delle regole dello Scrumble, e soprattutto sul come
|
|
giocarlo a distanza.</p></li>
|
|
<li><p>Sarebbero state utili lezioni più specifica sui tool da utilizzare, come SonarQube.</p></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
|
|
|
|
</div>
|
|
|
|
</div>
|
|
<footer>
|
|
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
|
|
<a href="../code/meta/index.html" class="btn btn-neutral float-right" title="Meta-documentazione" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
|
|
<a href="conclusions.html" class="btn btn-neutral float-left" title="Conclusioni" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
|
|
</div>
|
|
|
|
<hr/>
|
|
|
|
<div role="contentinfo">
|
|
<p>
|
|
© Copyright 2021, Gruppo 2.
|
|
|
|
</p>
|
|
</div>
|
|
|
|
|
|
|
|
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
|
|
|
|
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
|
|
|
|
provided by <a href="https://readthedocs.org">Read the Docs</a>.
|
|
|
|
</footer>
|
|
</div>
|
|
</div>
|
|
|
|
</section>
|
|
|
|
</div>
|
|
|
|
|
|
<script type="text/javascript">
|
|
jQuery(function () {
|
|
SphinxRtdTheme.Navigation.enable(true);
|
|
});
|
|
</script>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</body>
|
|
</html> |