From 2d69ecf709f4f9c6a62d55daba77c0fdf06a679c Mon Sep 17 00:00:00 2001 From: Nick Shirokov Date: Wed, 25 Feb 2026 18:45:19 +0300 Subject: [PATCH] docs: clarify PS1 as primary runtime, Python as derived port Co-Authored-By: Claude Opus 4.6 --- README.md | 2 +- docs/python-porting-guide.md | 10 ++++++++++ 2 files changed, 11 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 52df8c1a..bebe7a18 100644 --- a/README.md +++ b/README.md @@ -44,7 +44,7 @@ ### Кроссплатформенный режим (Python) -Для работы на **Linux/Mac** можно переключить навыки на Python 3: +На Windows рекомендуется использовать PS1-рантайм (по умолчанию) как более стабильный и протестированный. Python-порты — для **Linux/Mac** или если PowerShell недоступен. PS1-скрипты — мастер-версия; Python-порты производные (см. [Python Porting Guide](docs/python-porting-guide.md)). ```bash python scripts/switch-to-python.py # переключить на Python diff --git a/docs/python-porting-guide.md b/docs/python-porting-guide.md index eef357e9..e0255b8a 100644 --- a/docs/python-porting-guide.md +++ b/docs/python-porting-guide.md @@ -6,6 +6,16 @@ PowerShell 5.1 доступен только на Windows. Python-порты обеспечивают кроссплатформенность (Linux, Mac). Модель opt-in: PS1 — по умолчанию, Python — переключается скриптами. +## PS1 — мастер-версия + +**Приоритет при разработке, доработке, отладке и тестировании — у PS1-скриптов.** Python-порты являются производными копиями. Порядок работы: + +1. Вносите изменения в `.ps1` +2. Тестируйте и отлаживайте `.ps1` +3. Переносите готовые изменения в `.py` + +Не дорабатывайте `.py` без аналогичного изменения в `.ps1` — они должны оставаться функционально идентичными. + ## Переключение рантайма ```bash