You are right that it is a fundamental concept, but I'm not sure where I would explain it that would actually be seen by anyone needing to know it. Which is often the problem with fundamental concepts.
The other one I have is that people today think everything is stored “in the cloud” so are often confused as to whether their macros are tied to their license (they aren't) or they can just log in on a new Mac and their macros will be there (they wont - not unless you migrated your account from the old Mac), or that if they have migrated to a new Mac, that their macros will magically sync between the new and old (they wont). Understanding that your macros are stored locally on your Mac was a fundamental and obvious concept when Keyboard Maestro was created, but is not a fundamental concept that is not nearly as obvious and should be documented. But again, documented where - where would it actually be read by the people who need to know but don’t in time for it to actually be useful.
A new "Fundamental Concepts" page. The intro paragraph could provide examples for when you'd need to consider each concept.
The next question would be: What else should go on those new pages. I'm sure there's something (maybe lots), but I'd need to think more deeply about it.
Agreed.
This is a great example. It reminds me of some recent-ish articles about younger people not knowing about the concept of the file system.
As for the location in the official documentation, I think what I mention above is ok but ultimately most people will find it (whatever page it's on) via a search engines or LLM based prompts/questions. Especially if it's cross-referenced with this thread.