[mnriem]

Description

Correct the one-time usage guide to explain that uvx caches disposable environments for reuse rather than discarding them after each command. Replace the misleading re-download comparison with the distinction between a persistent tool environment and uv's disposable cache.

Only two prose passages in docs/install/one-time.md change; command examples are unchanged.

Testing

Set up this checkout's .venv and editable install using the local development guide. Run commands from the checkout root.

• Tested locally with .venv/bin/specify --help (Windows PowerShell: .\.venv\Scripts\specify.exe --help)
• Ran relevant existing tests with .venv/bin/python -m pytest tests -q (Windows PowerShell: .\.venv\Scripts\python.exe -m pytest tests -q); use affected test paths for focused checks and LC_ALL=en_US.UTF-8 on macOS
• Tested with a sample project (if applicable)

git diff --check passed. CLI checks, pytest, and sample-project testing were not run because this change only corrects documentation prose.

AI Disclosure

• I did not use AI assistance for this contribution
• I did use AI assistance (fill in the disclosure below)

AI disclosure: GitHub Copilot App using GPT-6.1 Sol (model ID: gpt-6.1-sol), in interactive mode with autonomous drafting and execution following user approval; reasoning effort was not explicitly configured. AI assistance covered identifying the documentation correction, writing the two prose edits, and preparing the commit and PR description. No code was changed.

[Copilot]

🟢 Approval recommended

The documentation now clearly distinguishes uvx’s reusable disposable cache from a persistent specify installation without changing the command examples, and no active review issues are identified.

No open issues 🎉

What changed in this PR

Clarifies uvx environment caching in the one-time usage guide, distinguishing uv’s reusable disposable cache from a persistent specify installation. Command examples remain unchanged.

Changes:

• Explains that uvx caches isolated environments for reuse.
• Clarifies that uvx does not install specify persistently on PATH.
• Replaces the misleading re-download comparison with the persistent-versus-disposable environment distinction.

File	Description
docs/​install/​one-time.md	Updates the uvx caching explanation and persistent-installation guidance.

_{Review effort: Lite (auto)}