Code Proximity Conjecture
#development #tips #heuristics
Let us call this heuristic the Code Proximity Conjecture
The probability of a documenting artifact (e.g. documentation, product roadmap, tickets, TODO task) being up to date is inversely proportional to the squared distance (in terms of hops by URL or files) of the artifact from the main code repository.
In other words:
Where p is the probability of the documenting artifact being up to date, and distance is the hop count by URL or file to the artifact relative to the main code repository.