Ivan/fix/doc codeblocks skip2#2052
Conversation
Fixes doc-codeblocks CI: nav_stack.md, g1/index.md, and visualization.md contain illustrative blocks that can't run in CI (placeholder syntax, missing imports across subprocess boundaries, hardware/network dependencies, gRPC server startup). Per docs/agents/docs/codeblocks.md, mark each with `skip`.
Greptile SummaryThis PR fixes CI failures introduced by the previous PR (#2043) by adding the
Confidence Score: 5/5Safe to merge — adds All changes are targeted and mechanical: blocks that reference hardware, placeholder module imports, undefined variables, or environment-mutating shell commands are correctly flagged No files require special attention. Important Files Changed
Sequence DiagramsequenceDiagram
participant PR as Pull Request
participant GH as GitHub Actions
participant BIN as bin/run-doc-codeblocks
participant MB as md-babel-py
PR->>GH: Push / synchronize
GH->>BIN: /entrypoint.sh bash -c "./bin/run-doc-codeblocks --ci --no-cache"
BIN->>MB: md-babel-py run --lang python,sh,node ./docs --recursive
loop "Each code block in docs/**"
MB->>MB: Check fence flags
alt "flag == skip"
MB-->>MB: Skip block (no execution)
else no flag
MB->>MB: Execute block
alt Execution succeeds
MB-->>BIN: OK
else Execution fails
MB-->>GH: CI FAILURE
end
end
end
BIN-->>GH: All blocks passed
GH-->>PR: doc-codeblocks check green
Reviews (2): Last reviewed commit: "checking if code change is required" | Re-trigger Greptile |
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
CI broken on prev PR #2043