unimore/pds-2021-g2-nest
unimore/pds-2021-g2-nest
1
Fork 0
mirror of https://github.com/pds-nest/nest.git synced 2024-11-22 21:14:18 +00:00
Code Activity
pds-2021-g2-nest/docs/build/html/development/suggestions.html

281 lines
10 KiB
HTML
Raw Normal View History

📔 Add missing docs
2021-05-28 12:28:36 +00:00
<!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 &mdash; 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" />
📔 Update stuff
2021-05-28 16:31:33 +00:00
<link rel="stylesheet" href="../_static/custom.css" type="text/css" />
📔 Add missing docs
2021-05-28 12:28:36 +00:00
<!--[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>
📔 Use future tense
2021-05-29 16:07:08 +00:00
<li class="toctree-l1"><a class="reference internal" href="../guide/updating.html">Aggiornamento</a></li>
📔 Add missing docs
2021-05-28 12:28:36 +00:00
</ul>
<p class="caption"><span class="caption-text">Relazione sul progetto</span></p>
<ul class="current">
📔 Add more things
2021-05-29 01:09:45 +00:00
<li class="toctree-l1"><a class="reference internal" href="goals.html">Introduzione</a></li>
📔 Add missing docs
2021-05-28 12:28:36 +00:00
<li class="toctree-l1"><a class="reference internal" href="tools.html">Strumenti utilizzati</a></li>
📔 Update a lot of things
2021-05-29 17:41:07 +00:00
<li class="toctree-l1"><a class="reference internal" href="process.html">Processo di sviluppo</a></li>
📔 Add missing docs
2021-05-28 12:28:36 +00:00
<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>
📔 Add more things
2021-05-29 01:09:45 +00:00
<li class="toctree-l1"><a class="reference internal" href="../code/database/index.html">Struttura del database</a></li>
📔 Add missing docs
2021-05-28 12:28:36 +00:00
<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> &raquo;</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>
📔 Update a lot of things
2021-05-29 17:41:07 +00:00
<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>
✨ Complete installation and updating pages
2021-05-29 16:03:44 +00:00
<ul>
📔 Update a lot of things
2021-05-29 17:41:07 +00:00
<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>
✨ Complete installation and updating pages
2021-05-29 16:03:44 +00:00
</ul>
</li>
📔 Update a lot of things
2021-05-29 17:41:07 +00:00
<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 &quot;salto nel buio&quot;:</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>
✨ Complete installation and updating pages
2021-05-29 16:03:44 +00:00
</ul>
</li>
</ul>
📔 Add missing docs
2021-05-28 12:28:36 +00:00
</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>
&#169; 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>
Copy permalink