Merge 49b5616 into a1b9627

Author: polRk

ydb/docs/en/core/contributor/devcontainer/index.md

@@ -0,0 +1,42 @@
+# Using Dev Container for YDB Client SDK Contributors
+
+- [Official Dev Containers Documentation](https://containers.dev/)
+- [VS Code Dev Containers Extension Documentation](https://code.visualstudio.com/docs/devcontainers/containers)
+
+Dev Container allows you to quickly set up a reproducible and isolated environment for developing and testing YDB client SDKs.
+
+## Why Use It
+
+- No need for manual environment and dependency setup.
+- The environment matches CI and other project contributors.
+- You can run integration tests with a local YDB database without extra preparation.
+- All necessary tools for development and testing are pre-installed.
+
+## Getting Started
+
+1. Install a container engine (e.g., Docker or Podman) and Visual Studio Code with the Dev Containers extension.
+2. Clone the repository of the required SDK.
+3. If the repository contains a `.devcontainer` folder, open the project in VS Code and select **Reopen in Container**.
+4. After the environment starts, use standard commands to build, test, and run the code.
+
+## Implementation Details in YDB SDKs
+
+### Java SDK
+- The [`devcontainer`](https://github.com/ydb-platform/ydb-java-sdk/tree/master/.devcontainer) contains a `Dockerfile`, `devcontainer.json`, and scripts.
+- The environment includes JDK, Gradle, and development tools.
+- You can extend the Dockerfile to install additional tools.
+
+### Go SDK
+- The [`devcontainer`](https://github.com/ydb-platform/ydb-go-sdk/tree/master/.devcontainer) contains a `Dockerfile`, `devcontainer.json`, `compose.yml`, and scripts.
+- A local YDB cluster is automatically started for integration tests.
+- All dependencies and the required Go version are pre-installed.
+
+### JavaScript/TypeScript SDK
+- The [`devcontainer`](https://github.com/ydb-platform/ydb-js-sdk/tree/main/.devcontainer) contains a `Dockerfile`, `devcontainer.json`, `compose.yml`, and scripts.
+- The environment includes Node.js, npm, TypeScript, and development tools.
+- When the devcontainer starts, a YDB cluster is automatically started for integration tests.
+
+### Python SDK (PR #590)
+- The [`devcontainer`](https://github.com/ydb-platform/ydb-python-sdk/pull/590/files) contains a `Dockerfile`, `devcontainer.json`, `compose.yml`, scripts, and automatic ydb-cli profile setup.
+- When the environment starts, a local YDB cluster is automatically started and access from the container is pre-configured.
+- All dependencies, flake8, tox, and ydb-cli are pre-installed.

ydb/docs/ru/core/contributor/devcontainer/index.md

@@ -0,0 +1,42 @@
+# Использование Dev Container для контрибьюторов клиентских SDK YDB
+
+- [Официальная документация Dev Containers](https://containers.dev/)
+- [Документация расширения VS Code Dev Containers](https://code.visualstudio.com/docs/devcontainers/containers)
+
+Dev Container позволяет быстро развернуть воспроизводимую и изолированную среду для разработки и тестирования клиентских SDK YDB.
+
+## Для чего использовать
+
+- Не требуется ручная настройка окружения и зависимостей.
+- Среда полностью совпадает с CI и другими участниками проекта.
+- Можно запускать интеграционные тесты с локальной базой YDB без дополнительной подготовки.
+- Все необходимые инструменты для разработки и тестирования уже установлены.
+
+## Как начать работу
+
+1. Установите контейнерный движок (например, Docker или Podman) и Visual Studio Code с расширением Dev Containers.
+2. Клонируйте репозиторий нужного SDK.
+3. Если в репозитории есть папка `.devcontainer`, откройте проект в VS Code и выберите команду **Reopen in Container**.
+4. После запуска среды используйте стандартные команды для сборки, тестирования и запуска кода.
+
+## Особенности реализации в SDK YDB
+
+### Java SDK
+- В [`devcontainer`](https://github.com/ydb-platform/ydb-java-sdk/tree/master/.devcontainer) есть `Dockerfile`, `devcontainer.json` и скрипты.
+- Окружение включает JDK, Gradle и инструменты для разработки.
+- Можно расширять Dockerfile для установки дополнительных средств.
+
+### Go SDK
+- В [`devcontainer`](https://github.com/ydb-platform/ydb-go-sdk/tree/master/.devcontainer) есть `Dockerfile`, `devcontainer.json`, `compose.yml` и скрипты.
+- Автоматически поднимается локальный кластер YDB для интеграционных тестов.
+- Все зависимости и нужная версия Go уже установлены.
+
+### JavaScript/TypeScript SDK
+- В [`devcontainer`](https://github.com/ydb-platform/ydb-js-sdk/tree/main/.devcontainer) есть `Dockerfile`, `devcontainer.json`, `compose.yml` и скрипты.
+- Окружение включает Node.js, npm, TypeScript и инструменты для разработки.
+- При запуске devcontainer автоматически поднимается кластер YDB для интеграционных тестов.
+
+### Python SDK (PR #590)
+- В [`devcontainer`](https://github.com/ydb-platform/ydb-python-sdk/pull/590/files) есть `Dockerfile`, `devcontainer.json`, `compose.yml`, скрипты и автоматическая настройка профиля ydb-cli.
+- При запуске среды автоматически поднимается локальный кластер YDB, к которому сразу настроен доступ из контейнера.
+- Все зависимости, flake8, tox, ydb-cli уже установлены.