Rigour

We are engineers, not archivists, yet our repositories overflow with the textual equivalent of dead weight: the inline prose comment. We’ve been taught to document everything, yet we often fail to recognize that a paragraph of English snaking through our logic is perhaps the single most reliable source of active misinformation in a codebase. This isn’t a critique of helpfulness; it’s a declaration that the medium is fundamentally broken for high-rigour environments. The time has come to treat sprawling, narrative comments as the most insidious form of technical debt, because unlike a genuine logic bug that throws an error, a bad comment quietly steers the next maintainer toward the wrong solution.