docs: clarify PS1 as primary runtime, Python as derived port

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Nick Shirokov
2026-02-25 18:45:19 +03:00
parent 88f74e96f0
commit 2d69ecf709
2 changed files with 11 additions and 1 deletions
+1 -1
View File
@@ -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
+10
View File
@@ -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