diff --git a/docs/faq.md b/docs/faq.md index 45e7fa2bd30..57843f71ffa 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -171,8 +171,8 @@ dependencies specified in `poetry.lock` into [Nox](https://nox.thea.codes/en/sta ### I don't want Poetry to manage my virtual environments. Can I disable it? While Poetry automatically creates virtual environments to always work isolated -from the global Python installation, there are valid reasons why it's not necessary -and is an overhead, like when working with containers. +from the global Python installation, there are rare scenarios where the use a Poetry managed +virtual environment is not possible or preferred. In this case, you can disable this feature by setting the `virtualenvs.create` setting to `false`: @@ -180,6 +180,13 @@ In this case, you can disable this feature by setting the `virtualenvs.create` s poetry config virtualenvs.create false ``` +{{% warning %}} +The recommended best practice, including when installing an application within a container, is to make +use of a virtual environment. This can also be managed by another tool. + +The Poetry team strongly encourages the use of a virtual environment. +{{% /warning %}} + ### Why is Poetry telling me that the current project's supported Python range is not compatible with one or more packages' Python requirements? Unlike `pip`, Poetry doesn't resolve for just the Python in the current environment. Instead it makes sure that a dependency