docs: move README translations to docs/readme

CONTRIBUTING.md

@@ -250,11 +250,13 @@ The project uses [Vitest](https://vitest.dev/) for testing.
 
 ### README Translations
 
-`README.md` (English) is the source of truth; `README.<lang>.md` files in the repository root are AI-assisted
-translations of it. When you change `README.md`, update the translations in the same pull request (or say in the PR
-that they need an update): keep the same `##`/`###` headings, the language switcher line and the version in the
-translation note in sync with `package.json`. Translate prose only — code, API names, commands and links stay as they
-are, and links to `docs/` keep pointing to the English guides. Check the result with:
+`README.md` (English) in the repository root is the source of truth; the `docs/readme/README.<lang>.md` files are
+AI-assisted translations of it. When you change `README.md`, update the translations in the same pull request (or say
+in the PR that they need an update): keep the same `##`/`###` headings, the language switcher line and the version in
+the translation note in sync with `package.json`. Translate prose only — code, API names and commands stay as they
+are, and links to `docs/` keep pointing to the English guides. Links in a translation are relative to `docs/readme/`:
+other translations are `README.<lang>.md`, English is `../../README.md`, root files are `../../<file>` and guides are
+`../guide/<page>.md`. Check the result with:
 
 ```bash
 npm run docs:check-i18n

README.md

@@ -8,7 +8,7 @@
     </small>
 </p>
 
-**English** | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
+**English** | [Українська](docs/readme/README.uk.md) | [Русский](docs/readme/README.ru.md) | [Deutsch](docs/readme/README.de.md) | [Français](docs/readme/README.fr.md) | [Español](docs/readme/README.es.md) | [Português](docs/readme/README.pt.md) | [Italiano](docs/readme/README.it.md) | [Nederlands](docs/readme/README.nl.md) | [Polski](docs/readme/README.pl.md) | [Čeština](docs/readme/README.cs.md) | [Türkçe](docs/readme/README.tr.md) | [العربية](docs/readme/README.ar.md) | [Bahasa Indonesia](docs/readme/README.id.md) | [Tiếng Việt](docs/readme/README.vi.md) | [日本語](docs/readme/README.ja.md) | [한국어](docs/readme/README.ko.md) | [简体中文](docs/readme/README.zh.md) | [繁體中文](docs/readme/README.zh-TW.md)
 
 # Boot Framework for Google Apps Script™
 

README.ar.md → docs/readme/README.ar.md

@@ -1,28 +1,28 @@
 <a name="top"></a>
 
-![Project banner for Google Apps Script Boot Framework](docs/assets/images/banner-1280x640.JPG)
+![Project banner for Google Apps Script Boot Framework](../assets/images/banner-1280x640.JPG)
 
 <p align="right">
     <small>
       <i>الفنانة: <a href="https://darynamikhailenko.com/?utm_source=github&utm_medium=readme&utm_campaign=apps-script-boot&utm_content=banner-artist-credit" title="Portfolio of Daryna Mikhailenko, the artist">Daryna Mikhailenko</a></i>
     </small>
 </p>
 
-[English](README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | **العربية** | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
+[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | **العربية** | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
 
 <div dir="rtl" lang="ar">
 
-> أُعدّت هذه الترجمة بمساعدة الذكاء الاصطناعي انطلاقًا من [README.md](README.md) للإصدار 1.10.0. ملف README الإنجليزي هو النسخة المرجعية. نرحّب بالتصحيحات: راجع [CONTRIBUTING.md](CONTRIBUTING.md).
+> أُعدّت هذه الترجمة بمساعدة الذكاء الاصطناعي انطلاقًا من [README.md](../../README.md) للإصدار 1.10.0. ملف README الإنجليزي هو النسخة المرجعية. نرحّب بالتصحيحات: راجع [CONTRIBUTING.md](../../CONTRIBUTING.md).
 
 # Boot Framework for Google Apps Script™
 
 </div>
 
 <p align="left">
   <a href="https://github.com/google/clasp"><img src="https://img.shields.io/badge/Built%20with-clasp-4285f4.svg" alt="Built with clasp"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/github/license/bootgs/boot?label=License" alt="License"></a>
-  <a href="SECURITY.md"><img src="https://img.shields.io/badge/Security-Policy-brightgreen.svg" alt="Security Policy"></a>
-  <a href="ROADMAP.md"><img src="https://img.shields.io/badge/Roadmap-View-blue.svg" alt="Roadmap"></a>
+  <a href="../../LICENSE"><img src="https://img.shields.io/github/license/bootgs/boot?label=License" alt="License"></a>
+  <a href="../../SECURITY.md"><img src="https://img.shields.io/badge/Security-Policy-brightgreen.svg" alt="Security Policy"></a>
+  <a href="../../ROADMAP.md"><img src="https://img.shields.io/badge/Roadmap-View-blue.svg" alt="Roadmap"></a>
   <a href="https://github.com/bootgs/boot/releases"><img src="https://img.shields.io/github/v/release/bootgs/boot?label=Release" alt="Latest release"></a>
 </p>
 
@@ -124,20 +124,20 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) {
 <div dir="rtl" lang="ar">
 
 الشرح الكامل، بما في ذلك `doPost` والتطبيق غير المتزامن `AsyncApp`، موجود في
-[دليل Quick Start](docs/guide/quick-start.md) (بالإنجليزية).
+[دليل Quick Start](../guide/quick-start.md) (بالإنجليزية).
 
 ## التوثيق
 
 الأدلة التفصيلية متاحة باللغة الإنجليزية:
 
-- [Quick Start](docs/guide/quick-start.md): إعداد `App` (متزامن) و`AsyncApp` (غير متزامن).
-- [Calling the API (Virtual Transport Layer)](docs/guide/virtual-transport-layer.md): معاملات الطلب، وأنواع MIME،
+- [Quick Start](../guide/quick-start.md): إعداد `App` (متزامن) و`AsyncApp` (غير متزامن).
+- [Calling the API (Virtual Transport Layer)](../guide/virtual-transport-layer.md): معاملات الطلب، وأنواع MIME،
   والاستدعاء عبر `google.script.run` وعنوان URL لتطبيق الويب، وتغليف الاستجابات.
-- [Decorators](docs/guide/decorators.md): مزخرفات الفئات والتوابع والمعاملات، والتحقق، والأنابيب المدمجة.
-- [Controlling the Response](docs/guide/responses.md): `ResponseEntity` و`@ResponseBody`.
-- [Advanced Examples](docs/guide/examples.md): الأنابيب والمعالجة الشاملة للأخطاء.
-- [AI Agent Skills](docs/guide/ai-agent-skills.md): القائمة الكاملة للمهارات وخيارات التثبيت.
-- [Boot.gs vs Spring Boot vs NestJS](docs/comparison.md): مقارنة بين البنى المعمارية.
+- [Decorators](../guide/decorators.md): مزخرفات الفئات والتوابع والمعاملات، والتحقق، والأنابيب المدمجة.
+- [Controlling the Response](../guide/responses.md): `ResponseEntity` و`@ResponseBody`.
+- [Advanced Examples](../guide/examples.md): الأنابيب والمعالجة الشاملة للأخطاء.
+- [AI Agent Skills](../guide/ai-agent-skills.md): القائمة الكاملة للمهارات وخيارات التثبيت.
+- [Boot.gs vs Spring Boot vs NestJS](../comparison.md): مقارنة بين البنى المعمارية.
 
 ## مهارات وكلاء الذكاء الاصطناعي
 
@@ -154,7 +154,7 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) {
 
 <div dir="rtl" lang="ar">
 
-القائمة الكاملة وطريقة التثبيت عبر Gemini CLI و`npx skills` موجودة في [AI Agent Skills](docs/guide/ai-agent-skills.md).
+القائمة الكاملة وطريقة التثبيت عبر Gemini CLI و`npx skills` موجودة في [AI Agent Skills](../guide/ai-agent-skills.md).
 
 ## موصى به
 
@@ -173,16 +173,16 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) {
 
 ## المساهمة
 
-نرحّب بالمساهمات! راجع [إرشادات المساهمة](CONTRIBUTING.md) للاطلاع على قواعد السلوك وطريقة إرسال طلبات الدمج
-(pull requests). للإبلاغ عن ثغرة أمنية، اتبع [سياسة الأمان](SECURITY.md).
+نرحّب بالمساهمات! راجع [إرشادات المساهمة](../../CONTRIBUTING.md) للاطلاع على قواعد السلوك وطريقة إرسال طلبات الدمج
+(pull requests). للإبلاغ عن ثغرة أمنية، اتبع [سياسة الأمان](../../SECURITY.md).
 
 ## خارطة الطريق
 
-اطّلع على [خارطة الطريق](ROADMAP.md) لمعرفة ما نخطط له في الإصدارات القادمة.
+اطّلع على [خارطة الطريق](../../ROADMAP.md) لمعرفة ما نخطط له في الإصدارات القادمة.
 
 ## سجل التغييرات
 
-للاطلاع على قائمة مفصّلة بالتغييرات والتحديثات، راجع [CHANGELOG](CHANGELOG.md).
+للاطلاع على قائمة مفصّلة بالتغييرات والتحديثات، راجع [CHANGELOG](../../CHANGELOG.md).
 
 ## الدعم
 
@@ -192,7 +192,7 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) {
 
 ## الترخيص
 
-هذا المشروع مرخّص بموجب [ترخيص Apache-2.0](LICENSE).
+هذا المشروع مرخّص بموجب [ترخيص Apache-2.0](../../LICENSE).
 
 ---
 

README.cs.md → docs/readme/README.cs.md

@@ -1,24 +1,24 @@
 <a name="top"></a>
 
-![Project banner for Google Apps Script Boot Framework](docs/assets/images/banner-1280x640.JPG)
+![Project banner for Google Apps Script Boot Framework](../assets/images/banner-1280x640.JPG)
 
 <p align="right">
     <small>
       <i>Umělkyně: <a href="https://darynamikhailenko.com/?utm_source=github&utm_medium=readme&utm_campaign=apps-script-boot&utm_content=banner-artist-credit" title="Portfolio of Daryna Mikhailenko, the artist">Daryna Mikhailenko</a></i>
     </small>
 </p>
 
-[English](README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | **Čeština** | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
+[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | **Čeština** | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
 
-> Tento překlad byl připraven s pomocí AI z [README.md](README.md) pro verzi 1.10.0. Referenční verzí je anglické README. Opravy jsou vítány: viz [CONTRIBUTING.md](CONTRIBUTING.md).
+> Tento překlad byl připraven s pomocí AI z [README.md](../../README.md) pro verzi 1.10.0. Referenční verzí je anglické README. Opravy jsou vítány: viz [CONTRIBUTING.md](../../CONTRIBUTING.md).
 
 # Boot Framework for Google Apps Script™
 
 <p align="left">
   <a href="https://github.com/google/clasp"><img src="https://img.shields.io/badge/Built%20with-clasp-4285f4.svg" alt="Built with clasp"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/github/license/bootgs/boot?label=License" alt="License"></a>
-  <a href="SECURITY.md"><img src="https://img.shields.io/badge/Security-Policy-brightgreen.svg" alt="Security Policy"></a>
-  <a href="ROADMAP.md"><img src="https://img.shields.io/badge/Roadmap-View-blue.svg" alt="Roadmap"></a>
+  <a href="../../LICENSE"><img src="https://img.shields.io/github/license/bootgs/boot?label=License" alt="License"></a>
+  <a href="../../SECURITY.md"><img src="https://img.shields.io/badge/Security-Policy-brightgreen.svg" alt="Security Policy"></a>
+  <a href="../../ROADMAP.md"><img src="https://img.shields.io/badge/Roadmap-View-blue.svg" alt="Roadmap"></a>
   <a href="https://github.com/bootgs/boot/releases"><img src="https://img.shields.io/github/v/release/bootgs/boot?label=Release" alt="Latest release"></a>
 </p>
 
@@ -108,20 +108,20 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) {
 ```
 
 Kompletní postup včetně `doPost` a asynchronní aplikace `AsyncApp` najdete v
-[průvodci Quick Start](docs/guide/quick-start.md) (v angličtině).
+[průvodci Quick Start](../guide/quick-start.md) (v angličtině).
 
 ## Dokumentace
 
 Podrobné průvodce jsou k dispozici v angličtině:
 
-- [Quick Start](docs/guide/quick-start.md): nastavení synchronní `App` a asynchronní `AsyncApp`.
-- [Calling the API (Virtual Transport Layer)](docs/guide/virtual-transport-layer.md): parametry požadavku, typy MIME,
+- [Quick Start](../guide/quick-start.md): nastavení synchronní `App` a asynchronní `AsyncApp`.
+- [Calling the API (Virtual Transport Layer)](../guide/virtual-transport-layer.md): parametry požadavku, typy MIME,
   volání přes `google.script.run` a URL webové aplikace, obalování odpovědí.
-- [Decorators](docs/guide/decorators.md): dekorátory tříd, metod a parametrů, validace a vestavěné pipes.
-- [Controlling the Response](docs/guide/responses.md): `ResponseEntity` a `@ResponseBody`.
-- [Advanced Examples](docs/guide/examples.md): pipes a globální zpracování chyb.
-- [AI Agent Skills](docs/guide/ai-agent-skills.md): úplný seznam skills a možnosti instalace.
-- [Boot.gs vs Spring Boot vs NestJS](docs/comparison.md): srovnání architektur.
+- [Decorators](../guide/decorators.md): dekorátory tříd, metod a parametrů, validace a vestavěné pipes.
+- [Controlling the Response](../guide/responses.md): `ResponseEntity` a `@ResponseBody`.
+- [Advanced Examples](../guide/examples.md): pipes a globální zpracování chyb.
+- [AI Agent Skills](../guide/ai-agent-skills.md): úplný seznam skills a možnosti instalace.
+- [Boot.gs vs Spring Boot vs NestJS](../comparison.md): srovnání architektur.
 
 ## Skills pro AI agenty
 
@@ -134,7 +134,7 @@ a validovat aplikace **Boot.gs**, a navíc obecné skills pro vývoj v Google Ap
 /plugin install bootgs@bootgs-skills
 ```
 
-Úplný seznam a instalaci pro Gemini CLI a `npx skills` najdete v [AI Agent Skills](docs/guide/ai-agent-skills.md).
+Úplný seznam a instalaci pro Gemini CLI a `npx skills` najdete v [AI Agent Skills](../guide/ai-agent-skills.md).
 
 ## Doporučujeme
 
@@ -150,16 +150,16 @@ a validovat aplikace **Boot.gs**, a navíc obecné skills pro vývoj v Google Ap
 ## Jak přispět
 
 Příspěvky jsou vítány! Pravidla chování a postup při odesílání pull requestů najdete v
-[pokynech pro přispěvatele](CONTRIBUTING.md). Chcete-li nahlásit zranitelnost, postupujte podle
-[bezpečnostní politiky](SECURITY.md).
+[pokynech pro přispěvatele](../../CONTRIBUTING.md). Chcete-li nahlásit zranitelnost, postupujte podle
+[bezpečnostní politiky](../../SECURITY.md).
 
 ## Plán vývoje
 
-V [plánu vývoje](ROADMAP.md) zjistíte, co chystáme v příštích verzích.
+V [plánu vývoje](../../ROADMAP.md) zjistíte, co chystáme v příštích verzích.
 
 ## Seznam změn
 
-Podrobný seznam změn a aktualizací najdete v [CHANGELOG](CHANGELOG.md).
+Podrobný seznam změn a aktualizací najdete v [CHANGELOG](../../CHANGELOG.md).
 
 ## Podpora
 
@@ -169,7 +169,7 @@ můžete ho podpořit přes [GitHub Sponsors](https://github.com/sponsors/Maksym
 
 ## Licence
 
-Tento projekt je licencován pod [licencí Apache-2.0](LICENSE).
+Tento projekt je licencován pod [licencí Apache-2.0](../../LICENSE).
 
 ---