🎓 Complete introduction (2/9)

docs/source/conf.py

@@ -111,7 +111,7 @@ html_extra_path = [
 # LaTeX rendering engine to use
 latex_engine = "lualatex"
 # LaTeX top level title type
-latex_toplevel_sectioning = "part"
+latex_toplevel_sectioning = "chapter"
 # LaTeX URLs rendering
 latex_show_urls = "footnote"
 # LaTeX theme

docs/source/docs/2_introduzione/index.rst

@@ -5,13 +5,21 @@
 Introduzione
 ************
 
-.. todo:: Scrivere i paragrafi di introduzione.
+Negli ultimi decenni, le possibilità per effettuare ricerca di gruppo si sono moltiplicate, grazie principalmente allo sviluppo della rete Internet, che permette comunicazione immediata tra istituzioni di tutto il mondo.
+
+Internet infatti ha portato alla creazione di strumenti informatici per facilitare la comunicazione e collaborazione remota, come email, chat, strumenti di revisione bozze e sistemi di controllo versione.
+
+Parallelamente a questi strumenti, sono stati sviluppati degli ambienti di lavoro a supporto della ricerca, che permettono la creazione di documenti interattivi, detti *notebook*, che combinano analisi di dati ad elementi multimediali come testo formattato, immagini e grafici.
+
+Il più popolare di questi ambienti di lavoro è l'ambiente computazionale Jupyter, che all'interno del notebook permette l'utilizzo di molteplici linguaggi di programmazione, sia per l'elaborazione dei dati, sia per la stesura del testo.
+
+Jupyter però ha alcuni problemi: è complesso da installare e mantenere, e non implementa di default molte funzionalità per la collaborazione, la confidenzialità e l'autenticazione.
 
 
 Obiettivo della tesi
 ====================
 
-L'obiettivo di questa tesi è quello di illustrare le basi per la realizzazione di un'applicazione web moderna, scalabile ed accessibile, per poi illustrare l'applicativo "*Sophon*" realizzato per migliorare la situazione della collaborazione online nella ricerca scientifica.
+L'obiettivo di questa tesi è quello di illustrare la situazione attuale della ricerca collaborativa, per poi descrivere lo sviluppo dell'applicativo "*Sophon*" realizzato con il fine di risolvere i problemi di Jupyter precedentemente descritti.
 
 
 Struttura della tesi
@@ -19,12 +27,12 @@ Struttura della tesi
 
 La tesi è strutturata nel seguente modo:
 
-#. nel primo capitolo `Sinossi` viene descritto molto brevemente il progetto realizzato;
+#. nel primo capitolo, :ref:`Sinossi`, viene descritto molto brevemente il progetto realizzato;
-#. nel secondo capitolo `Introduzione` viene introdotto il contesto della tesi, la tesi stessa e i suoi contenuti;
+#. nel secondo capitolo, :ref:`Introduzione`, viene introdotto il contesto della tesi, la tesi stessa e i suoi contenuti;
-#. nel terzo capitolo `Presentazione` viene presentata in dettaglio la situazione attuale della ricerca collaborativa;
+#. nel terzo capitolo, :ref:`Presentazione`, viene presentata in dettaglio la situazione attuale della ricerca collaborativa;
-#. nel quarto capitolo `Requisiti` venono elencati i requisiti che si voleva raggiungere con la realizzazione dell'applicativo;
+#. nel quarto capitolo, :ref:`Requisiti`, venono elencati i requisiti che si sono voluti raggiungere con la realizzazione dell'applicativo;
-#. nel quinto capitolo `Progetto` viene descritta la progettazione avvenuta, entrando nei dettagli della suddivisione in moduli e dei modelli creati;
+#. nel quinto capitolo, :ref:`Progetto`, viene descritta la progettazione avvenuta, entrando nei dettagli della suddivisione in moduli e delle astrazioni create;
-#. nel sesto capitolo `Implementazione` vengono trattate le specifiche tecniche implementative del progetto;
+#. nel sesto capitolo, :ref:`Implementazione`, vengono trattate le specifiche tecniche implementative del progetto;
-#. nel settimo capitolo `Applicazione` viene fatto un esempio di applicazione del progetto all'interno di un'Università;
+#. nel settimo capitolo, :ref:`Applicazione`, viene fatto un esempio di applicazione del progetto all'interno di un'Università;
-#. nell'ottavo capitolo `Conclusione` vengono tratte le conclusioni della tesi;
+#. nell'ottavo capitolo, :ref:`Conclusione`, vengono tratte le conclusioni della tesi;
-#. nel nono capitolo `Appendice` è infine inserito ulteriore materiale indirettamente relativo alla tesi.
+#. nel nono capitolo, :ref:`Appendice`, è infine inserito ulteriore materiale indirettamente relativo alla tesi.

docs/source/index.rst

@@ -1,9 +1,6 @@
-######
+##############################################################################
-Sophon
+Progettazione e sviluppo di Sophon, applicativo cloud a supporto della ricerca
-######
+##############################################################################
-**************************************
-Un centro di ricerca per le università
-**************************************
 
 .. toctree::
    :maxdepth: 6
@@ -12,15 +9,13 @@ Un centro di ricerca per le università
 
    docs/1_sinossi/index
    docs/2_introduzione/index
-   docs/3_presentazione/index
+.. docs/3_presentazione/index
-   docs/4_requisiti/index
+.. docs/4_requisiti/index
-   docs/5_progetto/index
+.. docs/5_progetto/index
-   docs/6_implementazione/index
+.. docs/6_implementazione/index
-   docs/7_applicazione/index
+.. docs/7_applicazione/index
-   docs/8_conclusione/index
+.. docs/8_conclusione/index
-   docs/9_appendice/index
+.. docs/9_appendice/index
-
-.. todo:: Rimuovere la sezione "da fare" nella versione definitiva.
 
 .. only:: html