EntitySchema Documentation -particularly SingleTableInheritance

[rdriggers]

Documentation Issue

The EntitySchema documentation is a bit lacking around a few items. In particular it is not clear to how Single Table Inheritance is accomplished via schemas.
A small example would be extremely helpful.
Another item is defining join columns and jointables is missing from the relationship bit within the complex example.

What was unclear or otherwise insufficient?

EntitySchema -> SingleTableInheritance (STI), JoinColumns, JoinTables.

Recommended Fix

Provide a STI example. Doesn't have to be anything fancy just something straight to the point.
For the complex example have 2 additional examples showing JoinColumn & JoinTable usage.

Additional Context

Are you willing to resolve this issue by submitting a Pull Request?

• ✖️ Yes, I have the time, and I know how to start.
• ✅ Yes, I have the time, but I don't know how to start. I would need guidance.
• ✖️ No, I don’t have the time, but I can support (using donations) development.
• ✖️ No, I don’t have the time and I’m okay to wait for the community / maintainers to resolve this issue.