Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Help message for `mdbook test` is a bit misleading

Open Beginner friendly
#3,237 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
88/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
rust
Domain
cli

Research direction

The change is to the one-line help text for the mdbook test subcommand, so search the Rust source for the existing string "Tests that a book's Rust code samples compile". Run mdbook test --help before and after editing to confirm the new wording appears in both mdbook --help and mdbook test --help. Done when the description says the samples are compiled and run, and the existing test suite still passes.

Written by the indexing model from the issue text.

Description

C-bug
Problem

The help message for mdbook test says Tests that a book's Rust code samples compile, but it actually runs them as well.

Steps

mdbook --help or mdbook test --help

Possible Solution(s)

Change it to something that better reflects its behavior, such as Compiles and runs a book's Rust code samples.

Notes

Although this is a very small change, I'd love the opportunity to make it myself if this is something you want to go ahead with.

Version
mdbook v0.5.4
Dominant language
Rust
Stars
22.2k
Forks
1.9k
Avg merge
4d 3h
Merged PRs (30d)
4

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from rust-lang/mdBook

All issues in rust-lang/mdBook

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.