Document AbstractDatabaseTable::EVENT_TABLE_CREATE

[paul-m]

Current Behavior

Currently, Drupal\common\Storage\AbstractDatabaseTable::EVENT_TABLE_CREATE says:

@todo This is unused.

This is incorrect. We should remove this todo.

We should also document how this event works.

Expected Behavior

Developers can understand from the code and inline comments when this event is dispatched, and how to appropriately respond to it.

Steps To Reproduce

...

Relevant log output (optional)

No response

Anything else?

Potential follow-ups:

• Give this event its own event class.
• Pass the schema array by reference.
• Inject the event_dispatcher service rather than using EventDispatcherTrait. See: Deprecate, disuse EventDispatcherTrait #4313