Greptile Summary

This docs-only PR adds three new sections and refactors an existing one across four documentation files to address the most common user confusion patterns found in GitHub discussions.

Python venv: The virtualenv section is restructured with a comparison table (python.uv_venv_auto vs _.python.venv), separate subsections for each mechanism, a warning that their code paths don't share options, and a tip clarifying that shims alone don't add venv/bin/ to PATH. Java JAVA_HOME: A new section fills an existing documentation gap — explaining that JAVA_HOME is only set with mise activate, with a cd . workaround for stale values and CI/IDE guidance. Slow prompts: A new #slow-shell-prompts section adds MISE_TIMINGS=1/2 diagnostics, verified correct against src/timings.rs (output goes to stderr; 2>&1 >/dev/null is the right redirect). The mise deactivate command exists and works correctly when called from an activated shell. All technical claims in the new content were cross-checked against the source code.

Confidence Score: 5/5

Docs-only PR is safe to merge; all technical claims verified against source code

No code changes, no P0/P1 issues found. All new content (MISE_TIMINGS behavior, mise deactivate, JAVA_HOME export, uv_venv_auto values) was cross-checked against src/timings.rs, src/cli/deactivate.rs, src/plugins/core/java.rs, and src/config/settings.rs. Only open concern (uv_venv_create_args accuracy) was already addressed in a prior review thread.

No files require special attention

Important Files Changed

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[User wants automatic\nvirtualenv activation] --> B{Is it a uv project?\ne.g. has uv.lock}
    B -- Yes --> C[python.uv_venv_auto\nin \[settings\]]
    B -- No --> D[_.python.venv\nin \[env\] section]
    C --> E['source' — activate existing .venv\n'create|source' — create if missing]
    D --> F[path + create + python_create_args\nor uv_create_args]
    E --> G[Requires mise activate\nor mise exec]
    F --> G
    G --> H[Shims alone do NOT\nadd venv/bin/ to PATH]

_{Reviews (3): Last reviewed commit: "docs: fix deactivate usage and don't cla..." | Re-trigger Greptile}

Hyperfine Performance

mise x -- echo

mise env

mise hook-env

mise ls

xtasks/test/perf