Skip to content

docs: update intro messaging#9418

Merged
jdx merged 1 commit intomainfrom
codex/update-intro-messaging
Apr 27, 2026
Merged

docs: update intro messaging#9418
jdx merged 1 commit intomainfrom
codex/update-intro-messaging

Conversation

@jdx
Copy link
Copy Markdown
Owner

@jdx jdx commented Apr 27, 2026

Summary

  • refresh the landing page, README, and intro docs to describe mise directly instead of through asdf, direnv, or make comparisons
  • align package metadata, CLI help, manpage, npm release metadata, and llms.txt with the new positioning
  • keep migration/comparison references where they are specifically useful rather than leading with them

Testing

  • mise run docs:build
  • git diff --check
  • pre-commit hook: hk lint suite, including cargo fmt --check, cargo check --all-features, shellcheck, shfmt, prettier, markdownlint, schema, taplo, stylua, lua-check, actionlint, and pkl

This PR was generated by an AI coding assistant.


Note

Low Risk
Low risk: changes are limited to documentation/help text and package metadata strings, with no functional code or behavioral changes beyond CLI descriptive text.

Overview
Updates mise’s positioning copy across the README, landing/docs pages, and reference docs to describe it directly as a single CLI for tools, environment variables, and tasks (instead of leading with comparisons to asdf/direnv/make).

Aligns this new messaging in distributed metadata and help outputs (Cargo/Nix/Snap/RPM/DEB/NPM descriptions, manpage, *.usage.kdl, communique.toml, llms.txt, and the CLI LONG_ABOUT string).

Reviewed by Cursor Bugbot for commit 25d3376. Bugbot is set up for automated code reviews on this repo. Configure here.

@gemini-code-assist
Copy link
Copy Markdown
Contributor

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented Apr 27, 2026

Greptile Summary

This PR refreshes all user-facing messaging across docs, CLI help, man pages, package metadata, and llms.txt to describe mise directly rather than through comparisons with asdf, direnv, and make. The new tagline "Dev tools, env vars, and tasks in one CLI" and updated descriptions are applied consistently across ~20 files.

Confidence Score: 5/5

Safe to merge — purely documentation and metadata changes with no code logic affected.

All 20 changed files contain only string/text updates (taglines, descriptions, README prose). No logic, control flow, or data structures are modified. Changes are consistent and well-coordinated across the codebase.

No files require special attention.

Important Files Changed

Filename Overview
README.md Rewrites "What is it?" section to describe mise directly instead of via tool comparisons; adds an introductory prose paragraph.
docs/index.md Updates landing page tagline, hero text, section heading, and feature card descriptions to remove comparison framing.
src/cli/mod.rs Updates LONG_ABOUT constant to new positioning description; no logic changes.
llms.txt Updates description bullets to remove tool comparisons; also fixes missing trailing newline at end of file.
scripts/release-npm.sh Updates npm package description from "polyglot runtime manager" to new tagline in both platform-specific and root package.json blocks.
snapcraft.yaml Updates snap summary and description; retains markdown-style links in description (pre-existing pattern).
packaging/copr/build-copr.sh Updates RPM spec Summary and %description fields generated for COPR builds.
packaging/rpm/mise.spec Updates RPM spec Summary and %description to new positioning text.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[User runs a command] --> B[mise activates]
    B --> C[Install & switch dev tools\nnode, python, terraform, ...]
    B --> D[Load env vars\nmise.toml, .env files, shell cmds]
    B --> E[Wire up tasks\nbuild, test, lint, deploy]
    C --> F[Command runs with correct environment]
    D --> F
    E --> F
Loading

Reviews (1): Last reviewed commit: "docs: update intro messaging" | Re-trigger Greptile

@jdx jdx enabled auto-merge (squash) April 27, 2026 01:33
@jdx jdx disabled auto-merge April 27, 2026 01:33
@jdx jdx merged commit d9d83a3 into main Apr 27, 2026
39 checks passed
@jdx jdx deleted the codex/update-intro-messaging branch April 27, 2026 01:49
@github-actions
Copy link
Copy Markdown

Hyperfine Performance

mise x -- echo

Command Mean [ms] Min [ms] Max [ms] Relative
mise-2026.4.23 x -- echo 23.2 ± 1.0 21.7 30.7 1.00
mise x -- echo 23.5 ± 0.9 22.0 30.9 1.01 ± 0.06

mise env

Command Mean [ms] Min [ms] Max [ms] Relative
mise-2026.4.23 env 22.7 ± 0.9 21.3 29.4 1.00
mise env 23.1 ± 0.8 21.8 28.3 1.02 ± 0.05

mise hook-env

Command Mean [ms] Min [ms] Max [ms] Relative
mise-2026.4.23 hook-env 23.3 ± 0.8 21.6 29.5 1.00
mise hook-env 24.0 ± 0.9 22.1 30.1 1.03 ± 0.05

mise ls

Command Mean [ms] Min [ms] Max [ms] Relative
mise-2026.4.23 ls 23.8 ± 0.7 22.3 26.3 1.00
mise ls 24.2 ± 0.9 22.7 33.1 1.02 ± 0.05

xtasks/test/perf

Command mise-2026.4.23 mise Variance
install (cached) 156ms 163ms -4%
ls (cached) 81ms 83ms -2%
bin-paths (cached) 82ms 84ms -2%
task-ls (cached) 826ms 817ms +1%

mise-en-dev added a commit that referenced this pull request Apr 27, 2026
### 🚀 Features

- **(ls-remote)** add `prereleases` setting and `--prerelease` flag by
@jdx in [#9415](#9415)

### 🐛 Bug Fixes

- **(http)** retry transient HTTP failures with backoff and warn on
rescue by @jdx in [#9414](#9414)
- **(release)** purge mise.en.dev CDN zone after each S3 publish by @jdx
in [#9416](#9416)

### 📚 Documentation

- prefix GitHub star count with ★ glyph by @jdx in
[#9417](#9417)
- update intro messaging by @jdx in
[#9418](#9418)
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.

1 participant