hook_entity_create() should clearly state the entity is unsaved and mention the hook can be invoked for dummy entities

API page: https://api.drupal.org/api/drupal/core%21lib%21Drupal%21Core%21Entity%21...

The 'create' in hook_entity_create() doesn't mean 'saved for the first time'.

The docs say:

> This hook runs after a new entity object has just been instantiated.

but I think this could be made even clearer.

Something like:

> The entity has not been saved; to act on an entity being saved for the first time use hook_entity_insert().

The docs should also say that it's possible the hook to be invoked for dummy entities. Field UI module for example creates a new entity to show the 'default value' form element for a field.