Documentazione ecologica
Le stime dell’impatto ambientale del web si aggirano tra il 2% e il 4% delle emissioni globali di gas serra, equivalente circa alle emissioni dell’industria aerea. Ci sono molti complessi fattori per calcolare l’impatto ambientale di un sito web, ma questa guida include dei consigli per ridurre l’impronta ecologica del tuo sito.
La buona notizia è che scegliere Starlight è un ottimo punto di partenza. Secondo il Website Carbon Calculator, questo sito è più pulito del 99% delle pagine web testate, producendo 0,01 g di CO₂ per pagina visitata.
Peso per pagina
Più dati una pagina web trasferisce, più risorse energetiche sono necessarie. Nell’aprile 2023, la pagina web media richiede all’utente di scaricare più di 2.000 KB secondo i dati dell’HTTP Archive.
Starlight costruisce le pagine nel modo più leggero possibile. Per esempio, alla prima visita, l’utente scaricherà meno di 50 KB di dati compressi — soltanto il 2,5 % della media dell’HTTP Archive. Inoltre, con una strategia appropriata di cache, successive visite potranno richiedere solamente 10 KB.
Immagini
Anche se Starlight fornisce un buon punto di partenza, le immagini possono velocemente aumentare il peso della pagina. Starlight usa il supporto ottimizzato degli asset di Astro per ottimizzare le immagini nei file Markdown e MDX.
Componenti UI
I componenti costruiti con framework UI come React o Vue possono facilmente aggiungere grandi quantità di JavaScript nella pagina. Dato che Starlight è costruito su Astro, i componenti come questo caricano zero JavaScript all’utente per default grazie alle Isole Astro.
Caching
La cache è utilizzata per salvare per un periodo di tempo dati già scaricati in modo che il browser possa riutilizzarli. Una buona strategia di cache permette all’utente di scaricare nuovi contenuti il prima possibile quando cambiano, ma anche evitare di scaricare nuovamente gli stessi più volte quando non sono cambiati.
Il modo più comune per configurarla è grazie al Cache-Control header HTTP.
Quando si utilizza Starlight, puoi controllare per quanto tempo salvare in cache nella cartella /_astro/.
Questa cartella contiene CSS, JavaScript e altri asset che possono essere salvati in cache per sempre, riducendo download non necessari:
Cache-Control: public, max-age=604800, immutableLa configurazione della cache dipende dal tuo host. Per esempio, Vercel applica questa strategia di cache per te senza configurazione richiesta, mentre puoi specificare degli headers personalizzati per Netlify aggiungendo il file public/_headers nel progetto:
/_astro/* Cache-Control: public Cache-Control: max-age=604800 Cache-Control: immutableConsumo energetico
Come una pagina web sia costruita può impattare l’energia richiesta per visualizzarla nel dispositivo dell’utente. Starlight riduce il consumo energetico del cellulare, tablet o computer che l’utente utilizza sfruttando pochissimo JavaScript.
Bisogna fare attenzione quando si vuole aggiungere funzionalità come script analitici o contenuti che utilizzano grandi quantità di JavaScript come video incorporati, dato che questi possono aumentare il consumo energetico.
Se necessario, si considerino Cabin, Fathom, o Plausible per funzionalità analitiche siccome non sono pesanti.
Video integrati come YouTube e Vimeo possono essere migliorati aspettando di caricare il video dopo interazione.
Pacchetti come astro-embed possono aiutare per servizi comuni.
Hosting
La piattaforma utilizzata per hostare un sito può avere un impatto significativo per l’impronta ecologica. I data center e server farm possono impattare di molto l’ambiente, usando grandi quantità di energia elettrica e d’acqua.
Scegliere un host che usi energia da fonti rinnovabili significa ridurre le emissioni di gas serra per il tuo sito. Il Green Web Directory è uno degli strumenti che si possono utilizzare per trovare host di questo tipo.
Comparazioni
Curioso di come altri framework per documentazioni si comparano? Questi test eseguiti con Website Carbon Calculator confrontano pagine simili costruite con diversi framework.
| Framework | CO₂ per visita | Voto |
|---|---|---|
| Starlight | 0.01g | A+ |
| Read the Docs | 0.05g | A+ |
| Sphinx | 0.06g | A+ |
| VitePress | 0.07g | A+ |
| Docus | 0.09g | A+ |
| docsify | 0.10g | A |
| Nextra | 0.11g | A |
| MkDocs | 0.19g | B |
| Docusaurus | 0.21g | B |
| GitBook | 0.43g | C |
| Mintlify | 1.22g | F |
Dati collezionati il 22 Luglio 2024. Clicca i link per vedere i dati aggiornati.
Altre risorse
Strumenti
Articoli e discussioni
- “Building a greener web”, conferenza di Michelle Barker
- “Sustainable Web Development Strategies Within An Organization”, articolo di Michelle Barker
- “A sustainable web for everyone”, conferenza di Tom Greenwood
- “How Web Content Can Affect Power Usage”, articolo di Benjamin Poulain e Simon Fraser