---
title: "Comment by Duko tools on \"I Built docproof: a CLI That Tests Your Documentation by Running It\" | Hashnode"
description: "\"Documentation is code that hasn't been executed\" is the reframe that makes this whole tool obvious in hindsight, every other artifact in a repo gets a CI check"
url: "https://hashnode.com/posts/docproof-test-your-docs-by-running-them/6a7475850190836b666799ba/comment/6a75992b1fa1f0f3ad2ad5dd"
---

[Discussion](https://hashnode.com/posts/docproof-test-your-docs-by-running-them/6a7475850190836b666799ba)

Comment [I Built docproof: a CLI That Tests Your Documentation by Running It](https://hashnode.com/posts/docproof-test-your-docs-by-running-them/6a7475850190836b666799ba)

[Duko tools](https://hashnode.com/@talha24ramzan)

[Aug 7](https://hashnode.com/posts/docproof-test-your-docs-by-running-them/6a7475850190836b666799ba/comment/6a75992b1fa1f0f3ad2ad5dd)

"Documentation is code that hasn't been executed" is the reframe that makes this whole tool obvious in hindsight, every other artifact in a repo gets a CI check the moment it can be automated, and the README was exempt purely because nobody built the runner, not because it mattered less.

The skip-directive design is the part I'd point to as the actual engineering insight, not the extraction/execution pipeline. A doc-testing tool that fails on every install command or credentialed API call would get disabled within a week, so the real work was building an escape hatch precise enough that "illustrative by design" and "actually broken" stay distinguishable, and the AI prompt explicitly being told "suggest a skip directive" instead of forcibly rewriting unrunnable samples is the same insight applied one layer up.

Sequential-shared-workspace-per-file over parallel execution is a good example of resisting the more impressive-sounding default. Parallel would demo well and be structurally wrong the moment a doc has a "create config, then read config" pattern, which is most real tutorials, matching execution order to how people actually write docs mattered more than raw throughput here.

[Ipseeta Priyadarshini](https://hashnode.com/@ipseeta)

[Aug 7](https://hashnode.com/posts/docproof-test-your-docs-by-running-them/6a7475850190836b666799ba/comment/6a75992b1fa1f0f3ad2ad5dd#reply-6a75aa2d000c300767b2f38c)

Thank you for reading it this closely, you've articulated the skip-directive thinking better than I did in the post. :)