[Stanley]

When Documentation Lies: Detecting Drift Between Code and Reality

There is no silver bullet, but there are 2 partially good approaches to address documentation drift: static checks and AI


https://hackernoon.com/when-documentatio...source=rss

[Terry A. Davis]

I find using things like Swagger can help, you design the API before touching anything, then you write a specification, and see if it operates within the expected tolerance, and refine from there.

Then you should be able to make an agent for your API using that document, which is now a contract for implementation.

Drift comes from lazy practice, or company structure not being built to reduce tech debt.