wording ref v 3.1

Author: hifly81

.github/workflows/generate-pdfs-on-release.yml

@@ -23,6 +23,7 @@ jobs:
         run: |
           sudo apt-get update
           sudo apt-get install -y pandoc texlive-xetex texlive-fonts-recommended texlive-plain-generic
+          sudo apt-get install -y poppler-utils
           pip install jupyter==1.1.1 nbconvert==7.16.6
       
       - name: Convert notebooks to PDF
@@ -38,6 +39,12 @@ jobs:
             echo "Converting $notebook to PDF..."
             jupyter nbconvert --to pdf "$notebook" --output-dir=pdfs || echo "Warning: Failed to convert $notebook"
           done
+          
+          # Merge all PDFs into one
+          echo "Merging PDFs..."
+          pdfunite pdfs/*.pdf corso-python-basic.pdf
+          find pdfs -type f -name "*.pdf" ! -name "corso-python-basic.pdf" -delete  
+          echo "✅ Conversion complete! Final merged file: corso-python-basic.pdf"
       
       - name: Upload PDFs to release
         env:

00_sommario_corso.ipynb

@@ -7,7 +7,7 @@
    "source": [
     "# 📚 Sommario del Corso Python per Principianti\n",
     "\n",
-    "Questo corso è un percorso introduttivo pensato per aiutarti a muovere i primi passi nel linguaggio Python. È uno dei pochi corsi per principianti di questo tipo disponibili interamente in italiano, progettato per offrirti un apprendimento chiaro e accessibile.\n",
+    "Questo corso è un percorso introduttivo pensato per imparare a muovere i primi passi nel linguaggio Python. È uno dei pochi corsi per principianti di questo tipo disponibili interamente in italiano, progettato per offrire un apprendimento chiaro e accessibile.\n",
     "\n",
     "---\n",
     "## 🧠 Python nell'Era dell'Intelligenza Artificiale\n",

01_primi_passi.ipynb

@@ -8,15 +8,15 @@
     "# ⌨️ Sintassi base di Python\n",
     "\n",
     "---\n",
-    "Dopo aver configurato il tuo ambiente e aver scritto il tuo primo programma, è il momento di esplorare la grammatica di base del linguaggio. In questa lezione, vedremo la sintassi fondamentale di Python: come si scrivono i commenti, l'importanza dell'indentazione, le variabili, i tipi di dati più comuni, le strutture di controllo del flusso e i cicli. Questi sono i concetti essenziali che userai in ogni programma."
+    "Dopo aver configurato l'ambiente di lavoro e aver scritto il primo programma, è il momento di esplorare la grammatica di base del linguaggio. In questa lezione, vedremo la sintassi fondamentale di Python: come si scrivono i commenti, l'importanza dell'indentazione, le variabili, i tipi di dati più comuni, le strutture di controllo del flusso e i cicli. Questi sono i concetti essenziali che si useranno in ogni programma."
    ]
   },
   {
    "cell_type": "markdown",
    "id": "d00ff8aa",
    "metadata": {},
    "source": [
-    "## 1. Commenti\n",
+    "## Commenti\n",
     "I commenti sono righe di testo nel codice che vengono ignorate dall'interprete Python. Servono per spiegare cosa fa una determinata parte del codice, renderlo più leggibile e documentarlo. Sono uno strumento essenziale per una buona programmazione.\n",
     "\n",
     "### Commento su singola riga\n",
@@ -61,17 +61,17 @@
    "metadata": {},
    "source": [
     "---\n",
-    "## 2. Indentazione: Perché è così importante? 🤔\n",
+    "## Indentazione: Perché è così importante? 🤔\n",
     "\n",
     "L'**indentazione** è uno dei concetti più importanti e unici della sintassi di Python. A differenza di molti altri linguaggi (come Java o C++) che usano parentesi graffe `{}` per definire blocchi di codice, Python usa lo spazio bianco. Ogni blocco di codice, come quello all'interno di un'istruzione `if` o di un ciclo `for`, deve essere indentato con la stessa quantità di spazi.\n",
     "\n",
     "### Perché Python usa l'indentazione?\n",
-    "A prima vista può sembrare una scelta strana, ma ci sono ottime ragioni dietro. I creatori di Python hanno voluto **forzare gli sviluppatori a scrivere codice più pulito e leggibile**. In altri linguaggi, l'indentazione è una convenzione di stile (puoi scrivere tutto su una riga se vuoi), ma in Python è una regola sintattica. Questo ha due vantaggi principali:\n",
+    "I creatori di Python hanno voluto **forzare gli sviluppatori a scrivere codice più pulito e leggibile**. In altri linguaggi, l'indentazione è una convenzione di stile (si può scrivere tutto su una riga se vuoi), ma in Python è una regola sintattica. Questo ha due vantaggi principali:\n",
     "\n",
     "1.  **Maggiore leggibilità:** Il codice indentato è più facile da leggere e da seguire visivamente. Quando tutti i programmatori seguono la stessa regola, la manutenzione del codice diventa molto più semplice, specialmente in team di sviluppo.\n",
     "2.  **Meno errori:** Non c'è ambiguità. Un blocco di codice inizia con un'indentazione maggiore e finisce quando l'indentazione torna al livello precedente. Non ci sono parentesi graffe da dimenticare, il che elimina una fonte comune di bug.\n",
     "\n",
-    "La convenzione (consigliata dallo standard PEP 8) è usare **4 spazi** per ogni livello di indentazione. Non mescolare spazi e tabulazioni per evitare errori, i moderni editor di testo lo gestiscono in automatico."
+    "La convenzione (consigliata dallo standard PEP 8) è usare **4 spazi** per ogni livello di indentazione. Non bisogna mescolare spazi e tabulazioni per evitare errori, i moderni editor di testo lo gestiscono in automatico."
    ]
   },
   {
@@ -114,9 +114,9 @@
    "metadata": {},
    "source": [
     "---\n",
-    "## 3. Variabili e assegnazioni\n",
+    "## Variabili e assegnazioni\n",
     "\n",
-    "Una **variabile** è un contenitore a cui assegni un valore. In Python, non è necessario dichiarare il tipo di una variabile in anticipo; l’interprete lo deduce automaticamente dal valore che le assegni. Questo approccio si chiama **tipizzazione dinamica** ed è stato scelto per rendere il linguaggio più **semplice e veloce da scrivere**, soprattutto per chi inizia o per chi sviluppa prototipi. Non dover specificare il tipo riduce la quantità di codice “boilerplate” e permette di concentrarsi sulla logica.\n",
+    "Una **variabile** è un contenitore a si assegna un valore. In Python, non è necessario dichiarare il tipo di una variabile in anticipo; l’interprete lo deduce automaticamente dal valore che le viene assegnato. Questo approccio si chiama **tipizzazione dinamica** ed è stato scelto per rendere il linguaggio più **semplice e veloce da scrivere**, soprattutto per chi inizia o per chi sviluppa prototipi. Non dover specificare il tipo riduce la quantità di codice “boilerplate” e permette di concentrarsi sulla logica.\n",
     "\n",
     "I nomi delle variabili devono iniziare con una lettera o un underscore (`_`) e possono contenere lettere, numeri e underscore. Inoltre, sono **case-sensitive**: ad esempio `variabile`, `Variabile` e `VARIABILE` sono considerati tre identificatori distinti.\n",
     "\n",
@@ -151,9 +151,9 @@
    "metadata": {},
    "source": [
     "---\n",
-    "## 4. Tipi di dati\n",
+    "## Tipi di dati\n",
     "\n",
-    "Ogni informazione che manipoliamo in Python ha un tipo. I tipi di dati più comuni sono:\n",
+    "Ogni informazione che viene manipolata in Python ha un tipo. I tipi di dati più comuni sono:\n",
     "\n",
     "| Tipo      | Descrizione                                | Esempio               |\n",
     "|-----------|--------------------------------------------|-----------------------|\n",
@@ -166,7 +166,7 @@
     "| `dict`    | Collezione non ordinata di coppie chiave-valore | `{'nome': 'Anna', 'età': 30}` |\n",
     "| `set`     | Collezione non ordinata di elementi unici  | `{1, 2, 3}`           |\n",
     "\n",
-    "Per conoscere il tipo di un dato o di una variabile, puoi usare la funzione `type()`."
+    "Per conoscere il tipo di un dato o di una variabile, si può usare la funzione `type()`."
    ]
   },
   {
@@ -203,7 +203,7 @@
     "### Tipi di dato complessi\n",
     "\n",
     "- **List (`list`)**: Una lista è una collezione di elementi **ordinata** e **modificabile**. È la struttura dati più versatile per memorizzare insiemi di dati che possono cambiare.\n",
-    "- **Tuple (`tuple`)**: Simile a una lista, ma una tupla è **immutabile**, il che significa che non puoi aggiungere, rimuovere o modificare i suoi elementi dopo la creazione. Questo la rende più efficiente in alcuni casi e ideale per dati che non devono cambiare.\n",
+    "- **Tuple (`tuple`)**: Simile a una lista, ma una tupla è **immutabile**, il che significa che non si possono aggiungere, rimuovere o modificare i suoi elementi dopo la creazione. Questo la rende più efficiente in alcuni casi e ideale per dati che non devono cambiare.\n",
     "- **Dictionary (`dict`)**: Un dizionario è una collezione di dati non ordinata che memorizza le informazioni come coppie di **chiave-valore**. È perfetta per associare un valore a una chiave specifica, come un nome a un'età o un codice a un prodotto.\n",
     "- **Set (`set`)**: Un set è una collezione di elementi non ordinata e **senza duplicati**. Viene usata per testare rapidamente l'appartenenza di un elemento o per eliminare i duplicati da una collezione."
    ]
@@ -242,7 +242,7 @@
    "source": [
     "---\n",
     "### Conversione di tipo (casting)\n",
-    "Puoi convertire un tipo in un altro usando funzioni come `int()`, `float()`, `str()`, `bool()`. Questo è spesso necessario, ad esempio, per convertire l'input di un utente da stringa a numero."
+    "E' possibile convertire un tipo in un altro usando funzioni come `int()`, `float()`, `str()`, `bool()`. Questo è spesso necessario, ad esempio, per convertire l'input di un utente da stringa a numero."
    ]
   },
   {
@@ -269,7 +269,7 @@
    "metadata": {},
    "source": [
     "---\n",
-    "## 5. Operatori aritmetici\n",
+    "## Operatori aritmetici\n",
     "\n",
     "Python supporta le classiche operazioni matematiche sui numeri.\n",
     "\n",
@@ -303,7 +303,7 @@
    "metadata": {},
    "source": [
     "---\n",
-    "## 6. Operatori di confronto e logici\n",
+    "## Operatori di confronto e logici\n",
     "\n",
     "Gli operatori di confronto e logici sono usati per prendere decisioni nel codice. Le loro espressioni restituiscono sempre un valore booleano (`True` o `False`).\n",
     "\n",
@@ -365,9 +365,9 @@
    "metadata": {},
    "source": [
     "---\n",
-    "## 7. Controllo del flusso: `if`, `elif`, `else`\n",
+    "## Controllo del flusso: `if`, `elif`, `else`\n",
     "\n",
-    "Il **controllo del flusso** ti permette di eseguire blocchi di codice in base a una condizione. Si usano le parole chiave `if`, `elif` (else if), e `else`.\n",
+    "Il **controllo del flusso** permette di eseguire blocchi di codice in base a una condizione. Si usano le parole chiave `if`, `elif` (else if), e `else`.\n",
     "\n",
     "Sintassi di base:\n",
     "```python\n",
@@ -377,8 +377,7 @@
     "    # code block se condition1 is False but condition2 is True\n",
     "else:\n",
     "    # code block if none of the previous conditions are true\n",
-    "```\n",
-    "Remember that indentation is essential to define code blocks!!"
+    "```\n"
    ]
   },
   {
@@ -403,7 +402,7 @@
    "metadata": {},
    "source": [
     "---\n",
-    "## 8. Cicli: `for` e `while`\n",
+    "## Cicli: `for` e `while`\n",
     "\n",
     "I cicli servono a ripetere un blocco di codice più volte.\n",
     "\n",
@@ -451,7 +450,7 @@
    "metadata": {},
    "source": [
     "---\n",
-    "## 9. Funzioni base: definizione e chiamata\n",
+    "## Funzioni base: definizione e chiamata\n",
     "\n",
     "Una **funzione** è un blocco di codice riutilizzabile che esegue un compito specifico. Le funzioni rendono il codice organizzato, modulare e più facile da gestire. Si definiscono con la parola chiave `def`.\n",
     "\n",
@@ -461,7 +460,7 @@
     "    # The code inside here runs only when the function is called\n",
     "    print(f\"Hello, {user_name}!\")\n",
     "```\n",
-    "Dopo la definizione, la funzione non esegue il codice. Devi **chiamarla** per attivarla."
+    "Dopo la definizione, la funzione non esegue il codice, occorre **chiamarla** per attivarla."
    ]
   },
   {
@@ -483,7 +482,7 @@
    "metadata": {},
    "source": [
     "---\n",
-    "## 10. Funzioni di input e output\n",
+    "## Funzioni di input e output\n",
     "\n",
     "### Funzione `print()`\n",
     "La funzione `print()` serve per visualizzare l'output a schermo. È estremamente versatile e supporta la formattazione avanzata con le **f-string** (`f-string`), un modo potente per incorporare variabili all'interno di una stringa in modo leggibile e conciso.\n",
@@ -519,26 +518,26 @@
     "## Esercizi\n",
     "\n",
     "### Esercizio 1: Variabili e tipi\n",
-    "- Crea una variabile `user_name` e assegnale il tuo nome come stringa.\n",
-    "- Crea una variabile `age` con la tua età come intero.\n",
-    "- Stampa una frase del tipo: \"Hello, my name is <user_name> and I am <age> years old.\"\n",
+    "- Creare una variabile `user_name` e assegnarle il proprio nome come stringa.\n",
+    "- Creare una variabile `age` con la propria età come intero.\n",
+    "- Stampare una frase del tipo: \"Hello, my name is <user_name> and I am <age> years old.\"\n",
     "\n",
     "### Esercizio 2: Operatori e confronto\n",
-    "- Scrivi un programma che chiede due numeri all’utente.\n",
-    "- Stampa se il primo numero è maggiore, minore o uguale al secondo.\n",
+    "- Scrivere un programma che chiede due numeri all’utente.\n",
+    "- Stampare se il primo numero è maggiore, minore o uguale al secondo.\n",
     "\n",
     "### Esercizio 3: Controllo del flusso\n",
-    "- Scrivi un programma che chiede un voto (0-100).\n",
+    "- Scrivere un programma che chiede un voto (0-100).\n",
     "- Se il voto è maggiore o uguale a 60, stampa “Passed”.\n",
     "- Se il voto è tra 40 e 59, stampa “Remedial”.\n",
     "- Altrimenti stampa “Failed”.\n",
     "\n",
     "### Esercizio 4: Ciclo for\n",
-    "- Stampa i numeri da 1 a 10 usando un ciclo `for`.\n",
+    "- Stampare i numeri da 1 a 10 usando un ciclo `for`.\n",
     "\n",
     "### Esercizio 5: Ciclo while\n",
-    "- Chiedi all’utente di indovinare un numero segreto (ad esempio 7).\n",
-    "- Continua a chiedere finché non indovina."
+    "- Chiedere all’utente di indovinare un numero segreto (ad esempio 7).\n",
+    "- Continuare a chiedere finché non indovina."
    ]
   },
   {