Metodologia & legenda

Filosofia

Il materiale delle lezioni è una guida al programma e allo stile d'esame, non una fonte infallibile. Ogni argomento è ricostruito pedagogicamente — idea fisica, formalismo, derivazione, ipotesi, limiti di validità, errori comuni — e ogni formula importante è verificata in passaggi, coerenza dimensionale e significato fisico. Gli errori del sorgente sono corretti nelle pagine e registrati nell'audit.

Standard di rigore

Per ogni formula importante il sito controlla:

• ipotesi di partenza (quali approssimazioni la rendono valida);
• passaggi matematici (completati quando il sorgente li salta);
• coerenza dimensionale;
• notazione (uniforme in tutto il sito);
• limiti di validità e casi limite;
• significato fisico e collegamenti con altri argomenti.

Non compaiono "si vede facilmente" se il passaggio non lo è, né proporzionalità spacciate per uguaglianze.

Stati delle pagine

Ogni pagina ha uno stato di validazione, mostrato come badge sotto il titolo. Una pagina è final solo se tutti i controlli sono superati.

Nota: nella fase attuale le pagine sono marcate content-checked/math-checked dove contenuto e matematica sono stati verificati; il passaggio a final richiede anche il controllo UX/accessibilità finale e l'integrazione delle animazioni.

Legenda dei box

Le pagine usano box colorati per distinguere i tipi di contenuto:

• 📘 Definizione — enunciato formale di un concetto.
• ⚡ Risultato — teorema o formula fondamentale.
• 🧮 Derivazione — passaggio passo-passo.
• ⚠️ Errore comune — trappola tipica, con correzione.
• 🎚️ Approssimazione — ipotesi/limite reso esplicito.
• 🔑 Formula chiave — richiama l'attenzione.
• 💡 Idea fisica — l'intuizione dietro al formalismo.
• 🧩 Esempio — applicazione numerica.
• ✏️ Nota — precisazione laterale.
• ⛔ Attenzione — avvertimento su casi delicati.

Stack tecnico (motivazione)

• Astro — output statico, zero-JS di default, Content Collections per le pagine.
• MDX — box didattici dentro il markdown.
• KaTeX — rendering matematico veloce.
• React (isole) — solo le visualizzazioni interattive vengono idratate.
• Tailwind v4 — design system responsive, dark mode per lo studio prolungato.

Deploy: statico, pronto per Cloudflare Pages (vedi README.md).