Versions:
doccmd is a lightweight, open-source utility written by Adam Dangoor that lets development teams treat code samples embedded in documentation exactly like source files under continuous integration. Designed for projects whose manuals, README files, or Sphinx sites contain fenced code blocks, the program parses Markdown, reStructuredText, and common wiki dialects, extracts every snippet that is tagged with a language identifier, and then pipes each snippet through the same linters, formatters, type-checkers, or test runners that are already configured for the main codebase. By validating examples automatically, maintainers can spot API drift, outdated syntax, or copy-paste errors before users encounter them. Typical use cases include running clang-format on C++ samples, passing Python blocks to black and mypy, or executing shell commands with shellcheck, all from a single CI job that otherwise only builds the prose. Because doccmd preserves original line numbers and generates standard tool diagnostics, pull-request bots can surface issues as inline comments without extra configuration. The tool is distributed as a cross-platform binary and as a pip-installable Python wheel; its only external dependency is the Python 3.8+ runtime. Since its first public commit, nine numbered releases have appeared, the current one being 2026.03.26.2, which relaxed parser strictness for newer CommonMark extensions and added an opt-in caching layer that skips unchanged blocks on repeated runs. doccmd is available for free on get.nero.com, with downloads provided via trusted Windows package sources (e.g. winget), always delivering the latest version, and supporting batch installation of multiple applications.
Tags: