Added Kora fully synced guides for RU and EN versions

Author: GoodforGod

mkdocs/config/en/mkdocs.yml

@@ -6,9 +6,47 @@ site_dir: "../../generated/en"
 site_name: Kora Framework 1.2.15
 site_url: https://kora-projects.github.io/kora-docs/en/
 nav:
-  - Examples:
-      - Repository examples: examples/kora-examples.md
-      - Hello world example: examples/hello-world.md
+  - Guides:
+      - Introduction: examples/kora-examples.md
+      - Basics:
+          - Hello world: guides/getting-started.md
+          - Introduction to Kora: guides/dependency-injection-introduction.md
+          - Dependency Injection: guides/dependency-injection.md
+          - HOCON Configuration: guides/config-hocon.md
+          - YAML Configuration: guides/config-yaml.md
+          - JSON: guides/json.md
+      - HTTP and API:
+          - HTTP Server: guides/http-server.md
+          - Advanced HTTP Server: guides/http-server-advanced.md
+          - HTTP Client: guides/http-client.md
+          - Advanced HTTP Client: guides/http-client-advanced.md
+          - OpenAPI HTTP Server: guides/openapi-http-server.md
+          - Advanced OpenAPI HTTP Server: guides/openapi-http-server-advanced.md
+          - OpenAPI HTTP Client: guides/openapi-http-client.md
+      - Database:
+          - JDBC Database: guides/database-jdbc.md
+          - Advanced JDBC Database: guides/database-jdbc-advanced.md
+          - Cassandra Database: guides/database-cassandra.md
+      - Advanced features:
+          - Cache: guides/cache.md
+          - Multi-Level Cache: guides/cache-multi-level.md
+          - Resilience: guides/resilient.md
+          - Validation: guides/validation.md
+      - Observability:
+          - Metrics: guides/observability-metrics.md
+          - Tracing: guides/observability-tracing.md
+          - Probes: guides/observability-probes.md
+      - Integrations:
+          - Kafka: guides/messaging-kafka.md
+          - gRPC Server: guides/grpc-server.md
+          - Advanced gRPC Server: guides/grpc-server-advanced.md
+          - gRPC Client: guides/grpc-client.md
+          - Advanced gRPC Client: guides/grpc-client-advanced.md
+          - S3: guides/s3.md
+      - Testing:
+          - Component testing: guides/testing-junit.md
+          - Integration Testing: guides/testing-integration.md
+          - Black-Box Testing: guides/testing-black-box.md
   - Documentation:
       - General: documentation/general.md
       - Dependency injection: documentation/container.md

mkdocs/config/ru/mkdocs.yml

@@ -6,9 +6,47 @@ site_dir: "../../generated/ru"
 site_name: Kora фреймворк 1.2.15
 site_url: https://kora-projects.github.io/kora-docs/ru/
 nav:
-  - Примеры:
-      - Репозиторий примеров: examples/kora-examples.md
-      - Ознакомительный пример: examples/hello-world.md
+  - Руководства:
+      - Вступление: examples/kora-examples.md
+      - Основы:
+          - Ознакомительные приложение: guides/getting-started.md
+          - Введение в Kora: guides/dependency-injection-introduction.md
+          - Внедрение зависимостей: guides/dependency-injection.md
+          - Конфигурация HOCON: guides/config-hocon.md
+          - Конфигурация YAML: guides/config-yaml.md
+          - JSON: guides/json.md
+      - HTTP и API:
+          - HTTP сервер: guides/http-server.md
+          - HTTP сервер продвинутый: guides/http-server-advanced.md
+          - HTTP клиент: guides/http-client.md
+          - HTTP клиент продвинутый: guides/http-client-advanced.md
+          - OpenAPI HTTP сервер: guides/openapi-http-server.md
+          - OpenAPI HTTP сервер продвинутый: guides/openapi-http-server-advanced.md
+          - OpenAPI HTTP клиент: guides/openapi-http-client.md
+      - База данных:
+          - База данных JDBC: guides/database-jdbc.md
+          - База данных JDBC продвинутая: guides/database-jdbc-advanced.md
+          - База данных Cassandra: guides/database-cassandra.md
+      - Расширенные возможности:
+          - Кеширование: guides/cache.md
+          - Многоуровневое кеширование: guides/cache-multi-level.md
+          - Отказоустойчивость: guides/resilient.md
+          - Валидация: guides/validation.md
+      - Наблюдаемость:
+          - Метрики: guides/observability-metrics.md
+          - Трассировка: guides/observability-tracing.md
+          - Пробы: guides/observability-probes.md
+      - Интеграции:
+          - Kafka: guides/messaging-kafka.md
+          - gRPC сервер: guides/grpc-server.md
+          - gRPC сервер продвинутый: guides/grpc-server-advanced.md
+          - gRPC клиент: guides/grpc-client.md
+          - gRPC клиент продвинутый: guides/grpc-client-advanced.md
+          - S3: guides/s3.md
+      - Тестирование:
+          - Компонентное тестирование: guides/testing-junit.md
+          - Интеграционное тестирование: guides/testing-integration.md
+          - Тестирование черным ящиком: guides/testing-black-box.md
   - Документация:
       - Основное: documentation/general.md
       - Контейнер: documentation/container.md

mkdocs/docs/en/documentation/cache.md

@@ -7,6 +7,8 @@ agent:
 Module for creating caches based on [Caffeine](https://github.com/ben-manes/caffeine) or [Redis](https://redis.io/docs/about/)
 using both declarative-style annotations and using their imperative style.
 
+For a step-by-step walkthrough before the reference details, see [Cache](../guides/cache.md) and [Multi-Level Cache](../guides/cache-multi-level.md).
+
 ## Caffeine { #caffeine }
 
 Library-based implementation of [Caffeine](https://github.com/ben-manes/caffeine) for in-memory caches within the application.

mkdocs/docs/en/documentation/config.md

@@ -6,6 +6,8 @@ agent:
 
 Module is responsible for mapping the values of configuration files to classes in Kora and then using them for application settings.
 
+For a step-by-step walkthrough before the reference details, see [HOCON Configuration](../guides/config-hocon.md) and [YAML Configuration](../guides/config-yaml.md).
+
 ## HOCON { #hocon }
 
 Support for [HOCON](https://github.com/lightbend/config/blob/master/HOCON.md) is implemented with [Typesafe Config](https://github.com/lightbend/config).

mkdocs/docs/en/documentation/container.md

@@ -9,6 +9,8 @@ injecting and then parallel initialization.
 
 The work of the container in Kora is divided into two parts: what is done at runtime and what is done at compile time.
 
+For a step-by-step walkthrough before the reference details, see [Dependency Injection Introduction](../guides/dependency-injection-introduction.md) and [Dependency Injection](../guides/dependency-injection.md).
+
 ## Compile Time { #compile-time }
 
 At compile time, components are searched building the dependency container of the entire application.

mkdocs/docs/en/documentation/database-cassandra.md

@@ -6,6 +6,8 @@ agent:
 
 Module provides a repository implementation for the [Cassandra](https://cassandra.apache.org/_/cassandra-basics.html) database using the [DataStax](https://docs.datastax.com/en/developer/java-driver/4.17/) driver.
 
+For a step-by-step walkthrough before the reference details, see [Cassandra Database](../guides/database-cassandra.md).
+
 ## Dependency { #dependency }
 
 ===! ":fontawesome-brands-java: `Java`"

mkdocs/docs/en/documentation/database-common.md

@@ -11,6 +11,8 @@ Other tools often have limitations on using specific functions of a particular d
 or a complex program language for building queries that requires additional and considerable time to learn and master,
 carries a lot of non-obviousness and potential errors on the part of the developer, and also sometimes has low performance.
 
+For a step-by-step walkthrough before the reference details, see [JDBC Database](../guides/database-jdbc.md) and [Advanced JDBC Database](../guides/database-jdbc-advanced.md).
+
 ## Entity { #entity }
 
 An entity is a representation of data from a database in the form of a class with fields.

mkdocs/docs/en/documentation/database-jdbc.md

@@ -7,6 +7,8 @@ agent:
 Module provides a repository implementation based on the [JDBC](https://proselyte.net/tutorials/jdbc/introduction/) database protocol
 and using [Hikari](https://github.com/brettwooldridge/HikariCP) for connection set management.
 
+For a step-by-step walkthrough before the reference details, see [JDBC Database](../guides/database-jdbc.md) and [Advanced JDBC Database](../guides/database-jdbc-advanced.md).
+
 ## Dependency { #dependency }
 
 ===! ":fontawesome-brands-java: `Java`"

mkdocs/docs/en/documentation/general.md

@@ -32,6 +32,8 @@ In order to achieve high-performance and efficient code, Kora stands on these pr
 - Using the most efficient implementations for integrations
 - Encouraging and using effective programming practices and natural language constructs
 
+For a step-by-step walkthrough before the reference details, see [Creating Your First Kora Application](../guides/getting-started.md) and [Dependency Injection Introduction](../guides/dependency-injection-introduction.md).
+
 ## Annotation Handlers { #annotation-handlers }
 
 The main pillar on which the Kora framework is built is annotation processors.
@@ -136,7 +138,7 @@ dependency `ru.tinkoff.kora:kora-parent` which requires to specify the version o
     }
     ```
 
-    You can also check out [Hello World example](../examples/hello-world.md) for a more detailed description.
+    You can also check out [Creating Your First Kora Application](../guides/getting-started.md) for a more detailed guided example.
 
 === ":simple-kotlin: `Kotlin`"
 
@@ -175,7 +177,7 @@ dependency `ru.tinkoff.kora:kora-parent` which requires to specify the version o
     }
     ```
 
-    You can also check out [Hello World example](../examples/hello-world.md) for a more detailed description.
+    You can also check out [Creating Your First Kora Application](../guides/getting-started.md) for a more detailed guided example.
 
 ## Dependencies { #dependencies }
 
@@ -330,3 +332,7 @@ This section describes the basic terms found throughout the documentation and wi
 - Module - [module](container.md#external-module-factory) is a pluggable dependency, often external, that provides some factory methods and new functionality to the application.
 - Component - [component](container.md#components) is a singleton class that implements some logic and is a dependency in a dependency container.
 - Aspect - is aspect logic that will extend the standard behavior of a method by via annotation before and/or after its execution.
+
+## First guide
+
+After reading the general overview, continue with [Creating Your First Kora Application](../guides/getting-started.md). It turns the framework basics into a small runnable HTTP service and gives the rest of the documentation a concrete shape.

mkdocs/docs/en/documentation/grpc-client.md

@@ -6,6 +6,8 @@ agent:
 
 Module for gRPC client service support based on [grpc.io](https://grpc.io/docs/languages/java/basics/) functionality.
 
+For a step-by-step walkthrough before the reference details, see [gRPC Client](../guides/grpc-client.md) and [Advanced gRPC Client](../guides/grpc-client-advanced.md).
+
 ## Dependency { #dependency }
 
 ===! ":fontawesome-brands-java: `Java`"