Перекомпоновка документации

2025-10-19 00:00:37 +03:00
parent f1e01274de
commit 42d5fcbc8a
1 changed files with 32 additions and 31 deletions
@@ -23,37 +23,6 @@

 Если что‑то не работает — смотрите «Типичные проблемы» и «Быстрый reset» ниже.

-## Локальное окружение разработчика
-
-Локальным окружением управляет [uv](https://docs.astral.sh/uv/) — он скачивает нужный Python и создаёт `.venv` на основе `pyproject.toml` / `uv.lock`.
-
-```bash
-uv sync
-```
-
-`uv sync` сам подтянет версию Python из `.python-version`/`pyproject.toml`, создаст `.venv` и установит зависимости. Для тех же действий можно использовать `make dev-sync`. Цель `make dev-setup` (или вручную `uv python install` + `uv python pin`) нужна только когда вы меняете версию Python или прогреваете кэш.
-
-> Если требуется «классическое» активированное окружение, после `uv sync` выполните `.\.venv\Scripts\Activate.ps1` в PowerShell или `source .venv/bin/activate` в Unix-терминале.
-
-Проверки и форматирование выполняем через uv:
-
-```bash
-make test            # uv run pytest -q
-make lint            # black/isort в режиме проверки
-make fmt             # автоформатирование black + isort
-```
-
-### Быстрый старт с uv
-
-```bash
-uv sync
-uv run pytest -q
-uv run black --check airflow tests
-```
-
-> Не устанавливайте пакеты напрямую через `pip install --user ...`. Если что-то уже попало в user-site, удалите `pip uninstall <package>` и проверьте `pip list --user`.
---
-
 ## 🚀 Быстрый старт (для новичков)

 ### Шаг 1: Подготовка окружения
@@ -155,6 +124,38 @@ make gp-psql                    # Подключение к Greenplum

 ---

+### Локальное окружение разработчика
+
+Локальным окружением управляет [uv](https://docs.astral.sh/uv/) — он скачивает нужный Python и создаёт `.venv` на основе `pyproject.toml` / `uv.lock`.
+
+```bash
+uv sync
+```
+
+`uv sync` сам подтянет версию Python из `.python-version`/`pyproject.toml`, создаст `.venv` и установит зависимости. Для тех же действий можно использовать `make dev-sync`. Цель `make dev-setup` (или вручную `uv python install` + `uv python pin`) нужна только когда вы меняете версию Python или прогреваете кэш.
+
+> Если требуется «классическое» активированное окружение, после `uv sync` выполните `.\.venv\Scripts\Activate.ps1` в PowerShell или `source .venv/bin/activate` в Unix-терминале.
+
+Проверки и форматирование выполняем через uv:
+
+```bash
+make test            # uv run pytest -q
+make lint            # black/isort в режиме проверки
+make fmt             # автоформатирование black + isort
+```
+
+#### Быстрый старт с uv
+
+```bash
+uv sync
+uv run pytest -q
+uv run black --check airflow tests
+```
+
+> Не устанавливайте пакеты напрямую через `pip install --user ...`. Если что-то уже попало в user-site, удалите `pip uninstall <package>` и проверьте `pip list --user`.
+---
+
+
 ## 📋 Что входит в стенд

 ### Основные компоненты