From 16c5212cfc083036a4c2b8d70287b16ddc6cdf1d Mon Sep 17 00:00:00 2001 From: Mirko Boehm Date: Sun, 1 Mar 2026 15:08:10 +0100 Subject: [PATCH 1/2] Release announcement for 0.92 Closes #54 --- announcements/0.92-release.md | 44 +++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 announcements/0.92-release.md diff --git a/announcements/0.92-release.md b/announcements/0.92-release.md new file mode 100644 index 0000000..cc1e152 --- /dev/null +++ b/announcements/0.92-release.md @@ -0,0 +1,44 @@ +# shelldoc 0.92 Social Media Posts + +## LinkedIn + +shelldoc 0.92 is out! + +This final release candidate before 1.0 adds command execution control features that make shelldoc more practical for real-world documentation testing. + +What's new: +- Dry-run mode (`--dry-run`/`-n`) to preview commands without execution +- Command timeouts (`--timeout`/`-t`) to prevent runaway tests +- Per-command timeouts via `shelldoctimeout` attribute in code blocks +- Graceful CTRL-C handling for clean test interruption +- Partial results saved to XML when tests are cancelled + +Dry-run mode lets you review commands before execution, and timeouts prevent tests from hanging indefinitely. + +0.92 is feature-complete for 1.0. Unless bugs are reported, this release will become 1.0 stable. + +Install: `go install github.com/mirkoboehm/shelldoc/cmd/shelldoc@v0.92.0` + +Project page: https://www.creative-destruction.org/project/shelldoc/ +GitHub: https://github.com/mirkoboehm/shelldoc + +#OpenSource #Documentation #DevTools #Golang + +--- + +## Mastodon + +shelldoc 0.92 released! + +What's new: +- Dry-run mode (`-n`) +- Command timeouts (`-t 30s`) and per-block `shelldoctimeout` +- Graceful CTRL-C handling + +Feature-complete for 1.0. Unless bugs are reported, this becomes stable. + +`go install github.com/mirkoboehm/shelldoc/cmd/shelldoc@v0.92.0` + +https://github.com/mirkoboehm/shelldoc + +#OpenSource #Documentation #DevTools #Golang From 828e55a29f5464fed137070c013d8880c6414036 Mon Sep 17 00:00:00 2001 From: Mirko Boehm Date: Tue, 3 Mar 2026 17:15:53 +0100 Subject: [PATCH 2/2] Highlight the bug reporting opportunity before 1.0 --- announcements/0.92-release.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/announcements/0.92-release.md b/announcements/0.92-release.md index cc1e152..62b45c2 100644 --- a/announcements/0.92-release.md +++ b/announcements/0.92-release.md @@ -15,7 +15,7 @@ What's new: Dry-run mode lets you review commands before execution, and timeouts prevent tests from hanging indefinitely. -0.92 is feature-complete for 1.0. Unless bugs are reported, this release will become 1.0 stable. +0.92 is feature-complete for 1.0. This is your last chance to report issues before the stable release. Try it against your documentation and let me know what breaks. Install: `go install github.com/mirkoboehm/shelldoc/cmd/shelldoc@v0.92.0` @@ -35,7 +35,7 @@ What's new: - Command timeouts (`-t 30s`) and per-block `shelldoctimeout` - Graceful CTRL-C handling -Feature-complete for 1.0. Unless bugs are reported, this becomes stable. +Feature-complete for 1.0. Last chance to report issues before stable release! `go install github.com/mirkoboehm/shelldoc/cmd/shelldoc@v0.92.0`