Merge branch 'main' into feat/pl-translation-bootstrap

Author: ArturSkowronski

html-generators/generate.java

@@ -366,7 +366,8 @@ String renderIndexCard(String tpl, Snippet s, String locale, Map<String, String>
             Map.entry("jdkVersion", s.jdkVersion()), Map.entry("cardHref", cardHref),
             Map.entry("cards.old", strings.getOrDefault("cards.old", "Old")),
             Map.entry("cards.modern", strings.getOrDefault("cards.modern", "Modern")),
-            Map.entry("cards.hoverHint", strings.getOrDefault("cards.hoverHint", "hover to see modern →"))));
+            Map.entry("cards.hoverHint", strings.getOrDefault("cards.hoverHint", "hover to see modern →")),
+            Map.entry("cards.learnMore", strings.getOrDefault("cards.learnMore", "learn more"))));
 }
 
 String renderWhyCards(String tpl, JsonNode whyList) {

html-generators/locales.properties

@@ -8,4 +8,5 @@ ar=🇸🇦 العربية
 fr=🇫🇷 Français
 ja=🇯🇵 日本語
 ko=🇰🇷 한국어
-pl=🇵🇱 Polski
+it=🇮🇹 Italiano
+pl=🇵🇱 Polski

templates/index-card.html

@@ -18,6 +18,6 @@ <h3>{{title}}</h3>
         </div>
         <div class="tip-card-footer">
           <span class="browser-support"><span class="dot"></span> JDK {{jdkVersion}}+</span>
-          <span class="arrow-link">→</span>
+          <span class="arrow-link">{{cards.learnMore}} →</span>
         </div>
       </a>

translations/content/it/collections/collectors-teeing.yaml

@@ -0,0 +1,18 @@
+---
+title: Collectors.teeing()
+oldApproach: Due passaggi
+modernApproach: teeing()
+summary: "Calcola due aggregazioni in un unico passaggio dello stream."
+explanation: "Collectors.teeing() invia ogni elemento a due collector downstream e unisce i risultati. Evita di scorrere i dati due volte o di usare un accumulatore mutabile."
+whyModernWins:
+- icon: ⚡
+  title: Passaggio singolo
+  desc: "Elabora lo stream una volta invece di due."
+- icon: 🧩
+  title: Componibile
+  desc: "Combina qualsiasi due collector con una funzione di unione."
+- icon: 🔒
+  title: Risultato immutabile
+  desc: "Unisci direttamente in un record o value object."
+support:
+  description: Ampiamente disponibile dal JDK 12 (marzo 2019)

translations/content/it/collections/copying-collections-immutably.yaml

@@ -0,0 +1,18 @@
+---
+title: Copia di collezioni in modo immutabile
+oldApproach: Copia manuale + Wrap
+modernApproach: List.copyOf()
+summary: "Crea una copia immutabile di qualsiasi collezione in una chiamata."
+explanation: "List.copyOf(), Set.copyOf() e Map.copyOf() creano snapshot immutabili di collezioni esistenti. Se la sorgente è già una collezione immutabile, non viene effettuata alcuna copia."
+whyModernWins:
+- icon: ⚡
+  title: Copia intelligente
+  desc: "Salta la copia se la sorgente è già immutabile."
+- icon: 📏
+  title: Una chiamata
+  desc: "Nessuna costruzione manuale di ArrayList + wrapping."
+- icon: 🛡️
+  title: Copia difensiva
+  desc: "Le modifiche all'originale non influenzano la copia."
+support:
+  description: Ampiamente disponibile dal JDK 10 (marzo 2018)

translations/content/it/collections/immutable-list-creation.yaml

@@ -0,0 +1,18 @@
+---
+title: Creazione di liste immutabili
+oldApproach: Wrapping verboso
+modernApproach: List.of()
+summary: "Crea liste immutabili in un'unica espressione pulita."
+explanation: "List.of() crea una lista veramente immutabile — nessun wrapping, nessuna copia difensiva. È ostile ai null (rifiuta elementi null) e strutturalmente immutabile. Il vecchio modo richiedeva tre chiamate annidate."
+whyModernWins:
+- icon: 📏
+  title: Una chiamata
+  desc: "Sostituisci tre chiamate annidate con un singolo metodo factory."
+- icon: 🔒
+  title: Veramente immutabile
+  desc: "Non è solo un wrapper — la lista stessa è immutabile."
+- icon: 🛡️
+  title: Null-safe
+  desc: "Rifiuta gli elementi null al momento della creazione, fallendo rapidamente."
+support:
+  description: Ampiamente disponibile dal JDK 9 (settembre 2017)

translations/content/it/collections/immutable-map-creation.yaml

@@ -0,0 +1,18 @@
+---
+title: Creazione di mappe immutabili
+oldApproach: Pattern Builder per Map
+modernApproach: Map.of()
+summary: "Crea mappe immutabili inline senza un builder."
+explanation: "Map.of() accetta coppie chiave-valore inline e restituisce una mappa immutabile. Per più di 10 voci, usa Map.ofEntries() con coppie Map.entry()."
+whyModernWins:
+- icon: 📏
+  title: Creazione inline
+  desc: "Non serve una mappa mutabile temporanea."
+- icon: 🔒
+  title: Risultato immutabile
+  desc: "La mappa non può essere modificata dopo la creazione."
+- icon: 🚫
+  title: Nessuna chiave/valore null
+  desc: "Le voci null vengono rifiutate immediatamente."
+support:
+  description: Ampiamente disponibile dal JDK 9 (settembre 2017)

translations/content/it/collections/immutable-set-creation.yaml

@@ -0,0 +1,18 @@
+---
+title: Creazione di set immutabili
+oldApproach: Wrapping verboso
+modernApproach: Set.of()
+summary: "Crea set immutabili con una singola chiamata factory."
+explanation: "Set.of() crea un set veramente immutabile che rifiuta null e elementi duplicati al momento della creazione. Niente più wrapping di set mutabili."
+whyModernWins:
+- icon: 📏
+  title: Conciso
+  desc: "Una riga invece di tre chiamate annidate."
+- icon: 🚫
+  title: Rileva duplicati
+  desc: "Lancia un'eccezione se passi accidentalmente elementi duplicati."
+- icon: 🔒
+  title: Immutabile
+  desc: "Nessuna aggiunta/rimozione possibile dopo la creazione."
+support:
+  description: Ampiamente disponibile dal JDK 9 (settembre 2017)

translations/content/it/collections/map-entry-factory.yaml

@@ -0,0 +1,18 @@
+---
+title: Factory Map.entry()
+oldApproach: SimpleEntry
+modernApproach: Map.entry()
+summary: "Crea voci di mappa con un metodo factory pulito."
+explanation: "Map.entry() sostituisce il verboso costruttore AbstractMap.SimpleEntry. Restituisce una voce immutabile, rendendola ideale per Map.ofEntries() e le operazioni stream."
+whyModernWins:
+- icon: 📏
+  title: Conciso
+  desc: "Una riga invece di tre con un'intenzione più chiara."
+- icon: 🔒
+  title: Immutabile
+  desc: "La voce restituita non può essere modificata."
+- icon: 🧩
+  title: Componibile
+  desc: "Funziona perfettamente con Map.ofEntries() per mappe grandi."
+support:
+  description: Ampiamente disponibile dal JDK 9 (settembre 2017)

translations/content/it/collections/reverse-list-iteration.yaml

@@ -0,0 +1,18 @@
+---
+title: Iterazione inversa di lista
+oldApproach: ListIterator manuale
+modernApproach: reversed()
+summary: "Itera su una lista in ordine inverso con un ciclo for-each pulito."
+explanation: "Il metodo reversed() di SequencedCollection restituisce una vista ordinata in senso inverso della lista. Questa vista è supportata dalla lista originale, quindi non si verifica alcuna copia. La sintassi del ciclo for potenziato rende l'iterazione inversa leggibile quanto quella diretta."
+whyModernWins:
+- icon: 📖
+  title: Sintassi naturale
+  desc: "Ciclo for potenziato invece del verboso ListIterator."
+- icon: ⚡
+  title: Nessuna copia
+  desc: "reversed() restituisce una vista — nessun overhead di prestazioni."
+- icon: 🧩
+  title: API coerente
+  desc: "Funziona su List, Deque, SortedSet in modo uniforme."
+support:
+  description: Ampiamente disponibile dal JDK 21 LTS (settembre 2023)