Skip to content

Conversation

@tacaswell
Copy link
Contributor

@tacaswell tacaswell commented Feb 9, 2026

I erred on this not needing an issue to say "the docs could be improved" as that is always a true statement ;).

The changes are split up into individual commits for ease of review. The primary changes are:

  • increased cross references
  • documenting the previously undocumented behavior that include-system-site-packages in pyvenv.cfg implicitly also controls user site-packages
  • an error in the site.py docstring (looks like it has always been wrong)

📚 Documentation preview 📚: https://cpython-previews--144637.org.readthedocs.build/

Otherwise it is not clear how to disable user site-packages.  Even though it is
directly above, the link from the search results put the top of the page on
PYHONUSERBASE and the user may not think to scroll up for critical context.
Now matches both site.rst and the actual implementation.
It is not otherwise documented that this implicitly disables user
site-packages.
@tacaswell tacaswell force-pushed the doc/usersite_details branch from 69f8de3 to 9cde670 Compare February 9, 2026 20:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant