Repository navigation
docs: refresh for Netclaw 0.28.2 (1/5): screenshots, generators, checks and sidebar - #140
Merged
Merged
Conversation
Aaronontheweb
added
documentation
This was referenced Oct 29, 2026
Closed
Aaronontheweb
force-pushed
the
docs/refresh-0.28-1-foundation
branch
from
October 29, 2026 19:08
d228564 to
ac4fdb9
Compare
…0.28 docs refresh Re-taken screenshots from the 0.28.2 release image, the containerised capture stack, the config and tools reference generators, the rendered-page and link checks, the Mattermost compose example, and the sidebar entries for the new pages that the following PRs add.
Aaronontheweb
force-pushed
the
docs/refresh-0.28-1-foundation
branch
from
October 29, 2026 19:28
ac4fdb9 to
a24d637
Compare
ubuntu-latest moved to 26.04, which the pinned Playwright has no Chromium build for, so the browser install failed and the build and deploy jobs stopped.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Part 1 of 5 of the docs refresh for Netclaw 0.28.2. This is the PR that lands on
dev. Parts 2 to 5 are stacked on top of it, and each one targets the branch below it.Merge order: after review, merge top-down: #144 into #143, #143 into #142, #142 into #141, #141 into this PR, then this PR into
dev. That way the site deploys once, with every page in place.CI: expect this PR's build to fail until parts 2 to 5 are merged into it. The sidebar here lists pages that only exist in the later parts. Once they're merged into this branch,
pr-validationruns against the complete set.What's in this part
Everything outside
src/content/docs:ghcr.io/netclaw-dev/netclaw:0.28.2release image (87 PNGs/GIFs), plus the containerised capture stack underscreenshots/(seed scripts, compose files, Mattermost and MCP OAuth fixtures, Playwright page shots) and the VHS tapes.scripts/gen-config-reference.mjs,scripts/gen-tools-reference.mjs).scripts/check-links.mjs(internal links and anchors) andscripts/check-rendered-pages.mjs, which fails the build when a page with a Mermaid diagram renders empty. The CI workflows install a cached headless Chromium so the diagrams render.public/_redirectsfor the moved Custom subagents page, andsrc/version.jsonnow set to 0.28.2.examples/mattermost-composestack that the new Mattermost tutorial uses.CLAUDE.md,AGENTS.md, thenetclaw-docsskill).How it was checked
Every page was re-verified against the 0.28.2 source. Commands, config blocks and compose files were run against the 0.28.2 image in throwaway containers. On the combined branch,
npm run build,npm run check-links(25,000+ references, 188 pages, no broken links or anchors), the rendered-page check andcheck-docs-versionall pass.Not executed, kept because the source confirms them: steps that need a real Slack or Discord workspace or a cloud account. Cloudflare Access is a caution box for now, and #139 tracks testing a recommended setup.
Issues
GitHub closes issues only from a PR that merges into
dev, so the full list lives here.Fixes #112
Fixes #113
Fixes #105
Fixes #120
Fixes #117
Fixes #118
Fixes #124
Fixes #130
Fixes #115
Fixes #101
Fixes #102
Fixes #103
Partly covered, left open: #71 (no
config-channels-resolve.pngyet), #88 (covered across the CLI and configuration webhook pages, no standalone guide), #104, #123, #126, #127, #129, #136, #95.