docs: clarify env use precedence over active virtualenvs

[xu430]

Document that an explicit poetry env use selection (via envs.toml) wins over a shell-activated VIRTUAL_ENV, and how to reset with poetry env use system.

Pull Request Check List

Resolves: #8247

• Added tests for changed code.
• Updated documentation for changed code.

[sourcery-ai]

Hey - I've left some high level feedback:

• The explanation of precedence between poetry env use and VIRTUAL_ENV is currently split between the ordered list and the later note; consider consolidating or cross-referencing these to avoid repetition and keep the behavior description in one place.
• When referring to the “virtualenvs cache” and envs.toml, it may help to briefly clarify how a user can locate or inspect that file (e.g., via poetry config virtualenvs.path or a short pointer) so the reference is immediately actionable.

Prompt for AI Agents

Please address the comments from this code review:

## Overall Comments
- The explanation of precedence between `poetry env use` and `VIRTUAL_ENV` is currently split between the ordered list and the later note; consider consolidating or cross-referencing these to avoid repetition and keep the behavior description in one place.
- When referring to the “virtualenvs cache” and `envs.toml`, it may help to briefly clarify how a user can locate or inspect that file (e.g., via `poetry config virtualenvs.path` or a short pointer) so the reference is immediately actionable.

---

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

• X
• Mastodon
• LinkedIn
• Facebook

_{Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.}