Skip to content

📝 docs(usage): document use_site_for_root parameter#438

Closed
gaborbernat wants to merge 1 commit into
tox-dev:mainfrom
gaborbernat:docs-use-site-for-root
Closed

📝 docs(usage): document use_site_for_root parameter#438
gaborbernat wants to merge 1 commit into
tox-dev:mainfrom
gaborbernat:docs-use-site-for-root

Conversation

@gaborbernat
Copy link
Copy Markdown
Member

The use_site_for_root parameter was added in #426 but wasn't documented in the Usage Guide. 📚 Users had no way to discover this feature when configuring system services running as root that need to use system-wide directories instead of root's home directory.

Added a dedicated section in the Usage Guide documenting use_site_for_root alongside other parameters like ensure_exists, multipath, and roaming. The documentation explains the Unix-only behavior, the default value for backwards compatibility, and includes a practical example showing how root processes redirect to site directories.

Fixes #433

The use_site_for_root parameter was added in tox-dev#426 but wasn't documented
in the Usage Guide. Users had no way to discover this feature when
configuring system services running as root that need to use system-wide
directories instead of root's home directory.

Added a dedicated section documenting use_site_for_root alongside other
parameters. The documentation explains the Unix-only behavior, the default
value for backwards compatibility, and includes a practical example showing
how root processes redirect to site directories.

Fixes tox-dev#433
@gaborbernat gaborbernat requested a review from ofek as a code owner February 14, 2026 16:18
@gaborbernat
Copy link
Copy Markdown
Member Author

Closing - will reopen original PR

@gaborbernat gaborbernat deleted the docs-use-site-for-root branch February 14, 2026 16:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Lacking documentation of use_site_for_root in Usage Guide

1 participant