From 41c49ba218b4ead813cd5db2c799d41f3449dfce Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Sat, 23 Nov 2024 14:53:51 -0800 Subject: [PATCH] Add warning not to create or activate a Python virtual environment (#1790) --- docs/_inc/_install-python-plone60.md | 7 +++++++ docs/_inc/_install-python-plone61.md | 8 +++++++- 2 files changed, 14 insertions(+), 1 deletion(-) diff --git a/docs/_inc/_install-python-plone60.md b/docs/_inc/_install-python-plone60.md index 49d1b2f15..dedf5c3c6 100644 --- a/docs/_inc/_install-python-plone60.md +++ b/docs/_inc/_install-python-plone60.md @@ -2,3 +2,10 @@ Installing Python is beyond the scope of this documentation. However, it is recommended to use a Python version manager, {term}`pyenv`, that allows you to install multiple versions of Python on your development environment without destroying your system's Python. Plone 6.0 requires Python version {{SUPPORTED_PYTHON_VERSIONS_PLONE60}}. + +```{warning} +Do not create or activate a Python virtual environment. +Doing so may cause installation errors. +Let the tools handle this for you. +Additionally the commands in this guide use explicit paths to packages. +``` \ No newline at end of file diff --git a/docs/_inc/_install-python-plone61.md b/docs/_inc/_install-python-plone61.md index 652d8dca9..3e540adc2 100644 --- a/docs/_inc/_install-python-plone61.md +++ b/docs/_inc/_install-python-plone61.md @@ -1,5 +1,11 @@ Installing Python is beyond the scope of this documentation. However, it is recommended to use a Python version manager, {term}`pyenv`, that allows you to install multiple versions of Python on your development environment without destroying your system's Python. -% TODO: uncomment this line after upgrading to plone-sphinx-theme and latest Sphinx which supports replacements inside includes. Plone 6.1 requires Python version {{SUPPORTED_PYTHON_VERSIONS_PLONE61}}. + +```{warning} +Do not create or activate a Python virtual environment. +Doing so may cause installation errors. +Let the tools handle this for you. +Additionally the commands in this guide use explicit paths to packages. +``` \ No newline at end of file