Back to feed
Dev.to
Dev.to
6/29/2026
I Deleted Our Confluence. The Code Is the Wiki Now.

I Deleted Our Confluence. The Code Is the Wiki Now.

Short summary

The author argues that hand-written wiki documentation inevitably drifts from code reality and proposes auto-generating docs from code analysis via Bodhiorchard, their open-source tool. This prevents stale documentation from breaking onboarding and misleading AI agents. Human-written BUDs (intent documents) versioned with code handle the 'why' that auto-extraction cannot infer.

  • •Auto-generated docs from code prevent wiki drift that breaks onboarding and misleads AI agents
  • •Author's tool scans repos to extract features, code locations, and commit history without manual documentation
  • •Human-written BUDs versioned with code handle the 'why' that auto-extraction cannot capture

Generated with AI, which can make mistakes.

#ai-tools#ai-agents#open-source
Read full article at Dev.to

Is this a good recommendation for you?

Comments

Failed to load comments. Please try again.

Explore more

My Project Docs Aren't For Humans Anymore. They're For an Agent That Re-Reads Them Every Session.
Dev.to
The original title is "Documentation Drift Breaks Coding Agents | Focused Labs"
Dev.to
The Myth of the Post-Documentation Era
Dev.to
Who Else Has Inherited a Codebase With Zero Comments and a Prayer?
Dev.to