documentation

shelldoc 1.0.0 is out. After three release candidates over six weeks, the relaunch that began in February with version 0.90 reaches its conclusion. This post looks back at what was done and forward at what comes next.

shelldoc version 0.92 is out. It is the final release candidate before 1.0. This is your last chance to report issues before the stable release. What’s new in 0.92? This release adds practical features requested by early adopters:

Today marks the release of shelldoc version 0.91, the second release candidate on the road to 1.0. This release focuses on code quality and test coverage. shelldoc version now reports the correct version even when installed via go install.

I am happy to announce the relaunch of shelldoc with version 0.90. After a maintenance hiatus, I have taken over active maintenance of shelldoc again in 2026. This release marks the first of three planned release candidates on the road to a stable 1.

shelldoc runs the shell commands embedded in your Markdown documentation and verifies their output matches expectations. This catches stale examples, broken install instructions, and outdated CLI flags before frustrated users open issues.