> only communicate the intent of the developer and not always the reality.

It’s nevertheless a very useful heuristics for anything with a programmatic interface. Nothing is a 100% perfect.