>but what's wrong with expecting people to know a little?

The issue here is that you're training users to rely on internal details.

Once users have to rely on internal details, you are stuck with maintaining these forever or face a constant stream of backlash.