Unclear interface for InspectableEvent

[jethron]

Is your feature request related to a problem? Please describe.
The InspectableEvent protocol property descriptions are too vague.
It is not clear that InspectableEvent can be either a "primitive" or "self-describing" event, and that only one of eventName or schema will be set depending on that category.
Since eventName is similar to the event_name field you see in data, it is reasonable to expect that InspectableEvent.eventName will be the schema's name for a self describing event; but instead the value is always nil which is confusing.

Describe the solution you'd like
API documentation for InspectableEvent should be clearer on the possible states/values it can have, and when.
Other documentation references (e.g. - also this section implies event.name instead of event.eventName which is confusing, and then uses event.schema as a value for eventName which is also confusing) should ideally include this information, too.

Describe alternatives you've considered
Digging through SDK code when someone has asked why event.eventName is always nil.