Show HN: Linecite – find and fix stale file:line references in your docs

Category: devtools

Tags: documentation, code-search, git, cli-tool, static-analysis

Score: 7.3/10 (Innovation: 7, Technical: 7, Documentation: 8, Utility: 7)

Linecite is a CLI tool that validates and synchronizes line-number citations in documentation by resolving them to symbols and quoted code fragments, then using git history to detect drift. It includes audit and adopt commands to assess existing citations and convert them to a more robust link format. The project addresses a genuine and quantified problem—67.6% of hand-written cited line numbers are wrong—with a well-designed specification syntax and CI integrations.

Target audience: technical writers, backend developers, documentation engineers, devops

Repository: https://github.com/gotoUSA/linecite · Python · MIT

View on Hacker News