[meta] Improve documentation for EntityType::$entity_keys

Problem/Motivation

The entity keys system is not well-documented, and a lot of other functionality in the entity system depends on it.

E.g.

- base field traits rely on it
- SQL storage possibly uses keys to define indexes

Steps to reproduce

Proposed resolution

Remaining tasks

User interface changes

Introduced terminology

API changes

Data model changes

Release notes snippet