docs: clarify per-version Gitea compatibility

README.md

@@ -36,6 +36,8 @@ The templates on `main` can replace Gitea's built-in mail templates without patc
 | ![Ink](docs/images/ink.png) | **Ink** | Publishing / News / Literature | Editorial print, navy & gold, newspaper layout, drop caps |
 | ![Aurora](docs/images/aurora.png) | **Aurora** | Premium SaaS / Mindfulness | Ethereal light gradients, deep purple & teal, atmospheric glow |
 
+The gallery shows the themes currently included in this repository; new themes can be added as separate directories under `themes/`.
+
 > Images are screenshots from the [local preview](preview/index.html). See [docs/images/README.md](docs/images/README.md) for capture instructions.
 
 [**Local preview gallery**](preview/index.html) — generate the preview data as described below, then open it in a browser for an interactive style switcher with desktop/mobile viewports and view mode (Modern, Source).
@@ -118,7 +120,7 @@ go run . dev
 
 ### Features
 
-- Theme switcher — browse all 10 visual styles
+- Theme switcher — browse all available visual styles
 - Template switcher — all 11 email types
 - View mode — Modern (rendered preview), Source (raw HTML)
 - Viewport toggle — Desktop 1386×780 / Mobile 390×780
@@ -131,7 +133,7 @@ go run . dev
 
 ```
 gitea-mail-templates/
-├── themes/               # 10 visual styles, 11 .tmpl files each
+├── themes/               # One directory per visual style, 11 .tmpl files each
 │   ├── ...               # Custom styles are added here as separate directories
 ├── preview/              # Live preview SPA
 │   ├── index.html        # Style/template/client/viewport switcher
@@ -177,7 +179,7 @@ gitea-mail-templates/
 <!-- RELEASE:SUMMARY -->
 - **Latest release:** [v28.0.0](https://gitea.kenanzhu.com/KenanZhu/GiteaMailTemplates/releases/latest)
 <!-- /RELEASE:SUMMARY -->
-- For Gitea 1.25.0–1.27.3, use [v1.27.3](https://gitea.kenanzhu.com/KenanZhu/GiteaMailTemplates/releases/tag/v1.27.3); see [COMPATIBILITY.md](COMPATIBILITY.md) for version-specific limits.
+- For other Gitea versions, check the [per-version compatibility matrix](COMPATIBILITY.md#compatibility-matrix) before choosing an archive; [PENDING] rows have no verified recommendation. The matching v1.27.2 tag has a known push-notification defect.
 <!-- TRACKER:UPSTREAM -->
 - **Upstream Gitea 28.1.0:** [PENDING]
 <!-- /TRACKER:UPSTREAM -->