May 20, 2026
Docs drama: can bots read or nah?
Show HN: Dari-docs – Optimize your docs using parallel coding agents
A tool that tests if your how-to guides are foolproof — and the comments are split
TLDR: dari-docs is a new tool that checks whether written instructions are clear enough for automated helpers to complete real tasks, then suggests fixes. Commenters were split between calling it genuinely useful, questioning why it needs to exist as a separate product, and worrying about uploading sensitive company docs.
A new project called dari-docs is pitching a very 2026 idea: don’t just ask whether your help guides make sense to humans — ask whether an automated helper can actually follow them without face-planting. The tool sends fake “developer agents” through real tasks, watches where they get confused, then suggests edits to make the instructions clearer. In plain English: it’s like hiring a bunch of tireless interns to try your setup guide and report back every spot where they got lost.
And the comments? Instantly more interesting than the product page. One camp was genuinely impressed, with people calling it a practical way to debug confusing instructions instead of just staring at them and hoping for the best. Aleesha_hacker basically gave it the gold star, saying this kind of testing feels far more useful than just reading docs and guessing.
But the skeptical crowd showed up fast. The biggest pushback was a very relatable: wait, why does this need to be a whole separate tool at all? One commenter openly admitted they still didn’t get the advantage over simply tossing the same task into an existing coding bot. That set the tone for the mini-drama: is this a smart new quality check, or just one more layer of tooling wrapped around something people already do?
Then came the side quests: one commenter plugged a teaser video like it was a movie trailer, while another dropped the classic privacy anxiety bomb — uploading your docs feels very sensitive to some teams. So the vibe is clear: part excitement, part confusion, part “absolutely not uploading my secret sauce,” which honestly is the most tech-comments energy possible.
Key Points
- •dari-docs is a command-line tool that tests whether documentation is usable by AI developer agents completing real tasks.
- •The tool identifies task-blocking issues in documentation, including ambiguity, missing setup steps, scattered context, and inconsistent terminology.
- •It can generate proposed documentation edits through an optimize workflow, with outputs downloaded for local review instead of directly modifying the repository.
- •dari-docs supports both managed mode through the hosted dari.dev Docs service and self-managed mode using agents in a user's own dari.dev organization.
- •Managed mode includes account-based credits, and the quickstart shows login, task checking, waiting for run completion, and downloading updated docs artifacts.