From 705bd56ed369e6ce6a2fe8e398453fb00fa01ddb Mon Sep 17 00:00:00 2001
From: Andrew Ghostuhin <me@torinasakura.name>
Date: Thu, 8 Jan 2026 03:08:19 +0300
Subject: [PATCH 1/2] Update README.md

Signed-off-by: Andrew Ghostuhin <me@torinasakura.name>
---
 README.md | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/README.md b/README.md
index 4be0722d..e274e9e6 100644
--- a/README.md
+++ b/README.md
@@ -47,16 +47,6 @@ NestJS Infrastructure-first toolkit
 - Microservices Registry
 - External Renderer
 
-## Development
-
-This repo uses [Yarn 4](https://yarnpkg.com/) and [ESM](https://nodejs.org/api/esm.html).
-
-### Build
-
-```bash
-yarn workspaces run build
-```
-
 ## Why
 
 - opinionated infra

From a07728f614db71dff0e1977fd5ef9935989aaa3b Mon Sep 17 00:00:00 2001
From: Andrew Ghostuhin <me@torinasakura.name>
Date: Sun, 11 Jan 2026 04:32:42 +0300
Subject: [PATCH 2/2] docs(common): more details

---
 README.md    | 20 ++++++++++++--------
 README_RU.md | 26 +++++++++-----------------
 2 files changed, 21 insertions(+), 25 deletions(-)

diff --git a/README.md b/README.md
index e274e9e6..abbe366d 100644
--- a/README.md
+++ b/README.md
@@ -47,15 +47,19 @@ NestJS Infrastructure-first toolkit
 - Microservices Registry
 - External Renderer
 
-## Why
+## Why this repo exists
 
-- opinionated infra
-- consistent error model
-- zero glue code between services
-- production-first defaults
+- NestJS does not provide built-in modules for gRPC, Kafka, authentication systems,
+  API gateways, or search engines
+- In production, this usually turns into custom glue code
+  and repeated infrastructure logic copied across services
+
+This repository provides infrastructure-level modules for NestJS
+that cover these concerns out of the box
+and remove the need to reimplement the same infra in every project.
 
 ## 🚀 Examples
 
-- [`grpc-http-proxy`](examples/grpc-http-proxy) - Echo HTTP proxy for gRPC services example.
-- [`grpc-playground`](examples/grpc-playground) - gRPC Playground integration example.
-- [`grpc-reflection`](examples/grpc-reflection) - gRPC Server Reflection usage example.
+- [`grpc-http-proxy`](examples/grpc-http-proxy) - Echo HTTP proxy for gRPC services example
+- [`grpc-playground`](examples/grpc-playground) - gRPC Playground integration example
+- [`grpc-reflection`](examples/grpc-reflection) - gRPC Server Reflection usage example
diff --git a/README_RU.md b/README_RU.md
index e147e8d2..a0a9f772 100644
--- a/README_RU.md
+++ b/README_RU.md
@@ -47,25 +47,17 @@ NestJS Infrastructure-first toolkit
 - Microservices Registry
 - External Renderer
 
-## Разработка
-
-Этот репозиторий использует [Yarn 4](https://yarnpkg.com/) и [ESM](https://nodejs.org/api/esm.html).
-
-### Сборка
-
-```bash
-yarn workspaces run build
-```
-
 ## Почему это удобно
 
-- Мнение об инфраструктуре уже сформировано
-- Согласованная модель ошибок
-- Отсутствие "склеивающего" кода между сервисами
-- Настройки, ориентированные на продакшн
+- NestJS не даёт готовых модулей для работы с gRPC, Kafka, системами аутентификации, API-шлюзами и поисковыми движками
+- В продакшене это быстро превращается в набор самописных решений и постоянный перенос одной и той же инфраструктурной логики между сервисами.
+
+Этот репозиторий — набор инфраструктурных модулей для NestJS,
+которые закрывают эти задачи из коробки
+и позволяют не собирать одну и ту же инфру руками в каждом проекте.
 
 ## 🚀 Примеры
 
-- [`grpc-http-proxy`](examples/grpc-http-proxy) - пример HTTP-прокси для gRPC-сервисов.
-- [`grpc-playground`](examples/grpc-playground) - пример использования gRPC Playground.
-- [`grpc-reflection`](examples/grpc-reflection) - пример использования gRPC Server Reflection.
+- [`grpc-http-proxy`](examples/grpc-http-proxy) - пример HTTP-прокси для gRPC-сервисов
+- [`grpc-playground`](examples/grpc-playground) - пример использования gRPC Playground
+- [`grpc-reflection`](examples/grpc-reflection) - пример использования gRPC Server Reflection