I'm always -- well, occasionally -- pointing developers on my team to the Schelling Point Wikipedia article[0] because it's a concept that seems fundamental to

I'm always -- well, occasionally -- pointing developers on my team to the Schelling Point Wikipedia article[0] because it's a concept that seems fundamental to developing maintainable code -- perhaps maintainable anything. The basic question is: where do I put this information that I -- or another perhaps entirely new developer -- will likely need at some indeterminate point in the future so that he or she will be able to locate it as quickly and effortlessly as possible? Some possible answers: README, docs, knowledge base, a variable name, a test, a code comment here, a code comment there, email the team, tell a co-worker, etc... Ultimately, I guess the answer comes down to a set of cultural habits and practices grounded in some assumptions about human nature. [0] https://en.wikipedia.org/wiki/Focal_point_(game_theory) https://en.wikipedia.org/wiki/Focal_point_(game_theory)