There's a minor documentation issue in
views.api.php. It says that the
views property should be used on an entity to point at the class that implements
EntityViewsDataInterface. This is wrong; it should be the
handlers.views_data property. This is what content entity types like
Going to attach a patch that tries to clarify this. Honestly, I think I could do better. Maybe we could add a
@see so that the person can find a good example more easily?