docs: remove how i use mise article

[jdx]

Summary

• remove the outdated How I use mise article
• remove remaining personal references/linkbacks from the shims docs and FAQ

Validation

• mise run docs:build

---

Note

Low Risk
Docs-only changes removing an article and a few personal callouts/links; no runtime or behavioral impact.

Overview
Removes the outdated docs/how-i-use-mise.md page from the docs.

Cleans up remaining personal callouts/linkbacks by deleting the “Jeff uses” note (and its link) from docs/dev-tools/shims.md and simplifying the Windows shims note in docs/faq.md to avoid personal workflow commentary.

^{Reviewed by Cursor Bugbot for commit b0c0458. Bugbot is set up for automated code reviews on this repo. Configure here.}

[greptile-apps]

Greptile Summary

Removes the personal "How I use mise" article and scrubs the remaining first-person references from docs/dev-tools/shims.md and docs/faq.md. The three changed files are clean, but the sidebar nav entry in docs/.vitepress/config.ts was not updated to remove the link to the deleted page.

• docs/how-i-use-mise.md deleted in full (122 lines of personal-use narrative).
• Personal info blocks removed from shims.md and faq.md, leaving only the objective content.
• docs/.vitepress/config.ts still has a nav entry pointing to /how-i-use-mise, which will produce a dead link or build warning now that the file is gone.

Confidence Score: 4/5

Safe to merge once the stale sidebar nav entry in config.ts is removed.

The three explicitly changed files look correct, but the VitePress sidebar config still references the deleted page, which could produce a broken nav link or docs build failure.

docs/.vitepress/config.ts still contains the nav entry for /how-i-use-mise that should have been removed alongside the deleted file.

Important Files Changed

Filename	Overview
docs/dev-tools/shims.md	Removes the personal 'This is the method Jeff uses' info block and the link to the now-deleted how-i-use-mise article.
docs/faq.md	Trims a personal aside from the Windows/WSL answer, leaving the factual content intact.
docs/how-i-use-mise.md	Entire file deleted — 122 lines of personal-use narrative removed from the docs site.

_{Reviews (1): Last reviewed commit: "docs: remove how i use mise article" | Re-trigger Greptile}

[gemini-code-assist]

Code Review

This pull request removes personal anecdotes and the 'How I use mise' documentation page from the repository. The changes include the deletion of the how-i-use-mise.md file and the removal of related references in docs/dev-tools/shims.md and docs/faq.md. I have no feedback to provide.

[github-actions]

Hyperfine Performance

mise x -- echo

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
mise-2026.5.12 x -- echo	68.5 ± 9.7	23.6	152.1	1.03 ± 0.17
mise x -- echo	66.5 ± 5.9	35.4	85.3	1.00

mise env

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
mise-2026.5.12 env	65.3 ± 6.2	35.6	84.1	1.00 ± 0.13
mise env	65.0 ± 5.4	32.0	78.6	1.00

mise hook-env

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
mise-2026.5.12 hook-env	68.3 ± 7.0	36.0	83.3	1.00
mise hook-env	68.4 ± 6.0	31.4	94.3	1.00 ± 0.14

mise ls

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
mise-2026.5.12 ls	50.0 ± 7.9	25.0	65.4	1.00
mise ls	53.6 ± 7.1	27.7	70.2	1.07 ± 0.22

xtasks/test/perf

Command	mise-2026.5.12	mise	Variance
install (cached)	304ms	309ms	-1%
ls (cached)	191ms	189ms	+1%
bin-paths (cached)	215ms	214ms	+0%
task-ls (cached)	305ms	311ms	-1%