Update README with current architecture and i18n info

- Update snippet count badge from 107 to 112
- Add translations and i18n section to architecture
- Fix generator description (JBang script, not fat JAR)
- Add link to i18n spec
- List all 9 supported languages

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: brunoborges

README.md

@@ -7,7 +7,7 @@ A collection of side-by-side code comparisons showing old Java patterns next to
 🔗 **[javaevolved.github.io](https://javaevolved.github.io)**
 
 [![GitHub Pages](https://img.shields.io/badge/GitHub%20Pages-live-brightgreen)](https://javaevolved.github.io)
-[![Snippets](https://img.shields.io/badge/snippets-107-blue)](#categories)
+[![Snippets](https://img.shields.io/badge/snippets-112-blue)](#categories)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Contributions welcome](https://img.shields.io/badge/contributions-welcome-orange)](#contributing)
 
@@ -42,14 +42,19 @@ Each comparison includes an explanation of *why* the modern approach is better,
 
 ## Architecture
 
-This site uses a **JSON-first** build pipeline:
+This site uses a **JSON/YAML-first** build pipeline:
 
-- **Source of truth**: Individual `content/category/slug.json` files (107 across 11 category folders)
-- **Templates**: `templates/` — shared HTML templates with `{{placeholder}}` tokens
-- **Generator**: `html-generators/generate.jar` — pre-built fat JAR that produces all HTML detail pages and `data/snippets.json`
+- **Source of truth**: Individual `content/category/slug.json` files (112 patterns across 11 category folders)
+- **Templates**: `templates/` — shared HTML templates with `{{placeholder}}` tokens for content and UI strings
+- **Generator**: `html-generators/generate.java` — JBang script that produces all HTML pages, localized variants, and `data/snippets.json`
+- **Translations**: `translations/strings/{locale}.yaml` for UI strings, `translations/content/{locale}/` for pattern content (YAML)
 - **Deploy**: GitHub Actions runs the generator and deploys to GitHub Pages
 
-Generated files (`site/category/*.html` and `site/data/snippets.json`) are in `.gitignore` — never edit them directly.
+Generated files (`site/category/*.html`, `site/{locale}/`, and `site/data/snippets.json`) are in `.gitignore` — never edit them directly.
+
+### Internationalization
+
+The site supports 9 languages: English, Deutsch, Español, Português (Brasil), 中文 (简体), العربية, Français, 日本語, and 한국어. See [`specs/i18n/i18n-spec.md`](specs/i18n/i18n-spec.md) for the full specification.
 
 ## Build & run locally
 
@@ -68,7 +73,7 @@ jwebserver -b 0.0.0.0 -d site -p 8090
 # Open http://localhost:8090
 ```
 
-The fat JAR is a self-contained ~2.2 MB file with all dependencies bundled. No JBang installation needed.
+The fat JAR is a self-contained ~2.2 MB file with all dependencies bundled. [JBang](https://jbang.dev) is needed to run the generator.
 
 For development on the generator itself, you can use JBang or Python — see [html-generators/README.md](html-generators/README.md) for details.